Assert

狀態碼測試

assertOk : 測試回傳狀態碼為 200

assertForbidden : 測試回傳狀態碼為 403

assertNotFound : 測試回傳狀態碼為 404

assertSuccessful : 測試回傳狀態碼為 200 ~ 299

<?php
$response = $this->json('GET', '/api/status-code');

// 測試狀態碼
$response->assertOk();          // 狀態碼 200
$response->assertNotFound();    // 狀態碼 404
$response->assertForbidden();   // 狀態碼 403
$response->assertSuccessful();   // 狀態碼 200 ~ 299

assertStatus : 測試指定狀態碼

<?php
$response = $this->json('GET', '/api/status-code');

// 測試狀態碼
$response->assertStatus(201);   // 狀態碼 201

assertRedirect : 測試是否為重新導向狀態碼

重新導向狀態碼:201, 301, 302, 303, 307, 308

<?php
$response = $this->call('GET', '/redirect-uri');

// 測試狀態碼
$response->assertRedirect($redirect_uri);

狀態測試

assertLocation : 測試目前網址位置

<?php
$response = $this->call('GET', '/specific-location');

// 測試是否包含指定資料
$response->assertLocation('/specific-location');

資料測試

assertSee : 測試是否有包含指定資料

<?php
$response = $this->call('GET', '/hello-world');

// 測試是否包含指定資料
$response->assertSee('<h1>Hello World</h1>');

assertSeeInOrder : 測試是否看到指定順序資料

<?php
$response = $this->call('GET', '/hello-world');

// 測試是否沒有包含指定資料
$response->assertSeeInOrder([
    '<h1>',
    'Hello',
    'World',
    '</h1>',
]);

assertSeeText : 測試是否看到指定文字(不包含 html tag)

<?php
$response = $this->call('GET', '/hello-world');

// 測試是否包含指定資料
$response->assertSeeText('Hello World');

assertSeeTextInOrder : 測試是否看到指定順序文字(不包含 html tag)

<?php
$response = $this->call('GET', '/hello-world');

// 測試是否沒有包含指定資料
$response->assertSeeTextInOrder([
    'Hello',
    'World',
]);

assertDontSee : 測試是否沒有看到指定資料

<?php
$response = $this->call('GET', '/hello-world');

// 測試是否沒有包含指定資料
$response->assertDontSee('<h1>No Hello World</h1>');

assertDontSeeText : 測試是否沒有看到指定文字

<?php
$response = $this->call('GET', '/hello-world');

// 測試是否沒有包含指定資料
$response->assertDontSeeText('No Hello World');
<?php
$response = $this->call('GET', '/get-cookie');

// 測試是否包含指定資料
$response->assertPlainCookie('cookie-name');
<?php
$response = $this->call('GET', '/get-cookie');

// 測試是否包含指定資料
$response->assertCookie('cookie-name', 'cookie-value', $encrypted = true, $unserialize = false);
<?php
$response = $this->call('GET', '/get-cookie');

// 測試是否包含指定資料
$response->assertCookieExpired('expired-cookie-name');

JSON 測試

assertJson : 測試 JSON 子集合資訊

測試的資料,僅需為原始資料的子集合即可

回傳資料

{
    "status" : true,
    "data": {
        "title": "Nam saepe earum molestias consequuntur et doloremque ea.",
        "body": "Consequatur iure omnis distinctio tempore accusamus...",
        "active": false
    }
}

測試 JSON 子集合資訊

$response = $this->json('GET', '/api/json');

// 測試成功
$response->assertJsonFragment([
    'status' => true,
]);

// 測試成功
$response->assertJsonFragment([
    'status' => true,
    'data' => [
        "active"=> false
    ]
]);

assertJsonFragment : 測試 JSON 部分鍵值資訊

回傳資料

{
    "status" : true,
    "data": {
        "title": "Nam saepe earum molestias consequuntur et doloremque ea.",
        "body": "Consequatur iure omnis distinctio tempore accusamus...",
        "active": false
    }
}

測試成功

$response = $this->json('GET', '/api/json');

// 測試成功
$response->assertJsonFragment([
    'status' => true,
]);

// 測試成功
$response->assertJsonFragment([
    'status' => true,
    'data' => [
        "title" => "Nam saepe earum molestias consequuntur et doloremque ea.",
        "body"=> "Consequatur iure omnis distinctio tempore accusamus...",
        "active"=> false
    ]
]);

測試 JSON 部分鍵值資訊

若有要指定測試鍵值的資料,則測試的鍵值資料必須包含所有的資訊

測試成功

$response = $this->json('GET', '/api/json');

// 測試成功
$response->assertJsonFragment([
    'status' => true,
]);

// 測試成功
$response->assertJsonFragment([
    'status' => true,
    'data' => [
        "title" => "Nam saepe earum molestias consequuntur et doloremque ea.",
        "body"=> "Consequatur iure omnis distinctio tempore accusamus...",
        "active"=> false
    ]
]);

測試失敗

// 測試失敗
$response->assertJsonFragment([
    'status' => true,
    'data' => [
        "title" => "Nam saepe earum molestias consequuntur et doloremque ea.",
    ]
]);

assertJsonStructure : 測試 JSON 結構

回傳資料

{
    "status" : true,
    "data": {
        "title": "Nam saepe earum molestias consequuntur et doloremque ea.",
        "body": "Consequatur iure omnis distinctio tempore accusamus...",
        "active": false
    }
}

測試 JSON 結構

$response = $this->json('GET', '/api/json');

$response->assertJsonStructure([
    'status',
    'data' => [
        'body',
        'title',
        'active'
    ]
])

assertExactJson : 測試 JSON 資料是否完全符合

回傳資料

{
    "status" : true,
    "data": {
        "title": "Nam saepe earum molestias consequuntur et doloremque ea.",
        "body": "Consequatur iure omnis distinctio tempore accusamus...",
        "active": false
    }
}

測試 JSON 結構

$response = $this->json('GET', '/api/json');

$response->assertExactJson([
    'status' => true,
    'data' => [
        "title" => "Nam saepe earum molestias consequuntur et doloremque ea.",
        "body"=> "Consequatur iure omnis distinctio tempore accusamus...",
        "active"=> false
    ]
])

參考資料

KeJyun 最新新書推薦
- Laravel 5 for beginner 新手道場:優雅運用框架快速開發 PHP 網站
- Laravel框架开发详解:从零基础到运用框架快速开发PHP网站

Laravel 是 PHP 的框架(Framework),提供了很多開發網站或 API 所需的工具及環境,經過簡單的設定就可以完成資料的處理及顯示,使開發者可以很優雅且快速的開發出各個不同的產品。本書適合有 PHP 基礎的人,但不知道要怎麼選擇框架,或者不用框架的人也能夠明白它的好處。

雖然 WordPress 也能夠架站,但如果有客製化需求,要開發各式各樣的網站,或提供 App 使用的 API,如此一來你只能選擇用框架,而 Laravel 是目前最受歡迎的。

本書將解說為什麼要使用框架,以及理解框架的優缺點後,要怎麼選擇框架,並用框架快速建構一個網站。除非必要,否則書中會避免專業技術用語,盡量使用最生活化易懂的例子及語氣,讓大家更容易進入 Laravel 的世界。

Laravel 5 for beginner 新手道場:優雅運用框架快速開發 PHP 網站

購書連結

Laravel框架开发详解:从零基础到运用框架快速开发PHP网站

購書連結

comments powered by Disqus