Laravel测试指南：正确区分功能测试与浏览器测试方法

在使用laravel进行测试驱动开发（tdd）时，开发者常混淆功能测试（feature test）与浏览器测试（browser test）的方法。本文将解释为何在功能测试中调用`visit()`方法会导致错误，并指导读者正确使用`get()`等http请求方法进行功能测试，避免常见的兼容性问题，确保测试的正确执行。

在Laravel框架中进行测试驱动开发（TDD）是构建健壮应用的关键实践。然而，初学者常会遇到一个常见问题：在功能测试（Feature Test）中误用浏览器测试（Browser Test）的方法，导致Call to undefined method ...::visit()之类的错误。这通常是由于对Laravel不同测试类型的底层机制理解不足所致。

错误现象分析

当你在Tests\Feature命名空间下的测试文件中，例如ExampleTest.php，尝试使用$this->visit('/')这样的方法时，PHPUnit会报告Call to undefined method Tests\Feature\ExampleTest::visit()错误。

示例代码中，问题在于：

<?php

namespace Tests\Feature;

use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;

class ExampleTest extends TestCase
{
    public function test_example()
    {
        // 错误的使用方式：visit() 方法不属于 Feature Test
        $response = $this->visit('/')->see('Laravel');
        $response->assertStatus(200);
    }
}

这个错误明确指出Tests\Feature\ExampleTest类（它继承自Tests\TestCase）没有名为visit()的方法。这是因为visit()是Laravel Dusk（一个浏览器自动化测试工具）提供的API，而非Laravel内置的功能/单元测试（Illuminate\Foundation\Testing\TestCase）所包含的方法。

理解Laravel的测试生态系统

Laravel提供了多种测试工具，每种都有其特定的应用场景和方法集。正确区分它们是编写有效测试的前提。

白瓜面试

白瓜面试 - AI面试助手,辅助笔试面试神器

40

查看详情

1. 功能测试 (Feature Testing) / 单元测试 (Unit Testing)

• 命名空间: 通常位于Tests\Feature或Tests\Unit。
• 基类: 继承自Tests\TestCase，该类又继承自Illuminate\Foundation\Testing\TestCase。
• 目的:
  • 单元测试: 侧重于测试单个类或方法，确保其逻辑正确性，不涉及HTTP请求或数据库交互（除非是mocked）。
  • 功能测试: 侧重于测试应用的HTTP层，模拟用户向应用发送HTTP请求（GET, POST, PUT, DELETE等），并验证响应（状态码、JSON结构、HTML内容等）。它不启动真实的浏览器，而是在PHP环境中模拟HTTP请求和响应周期。
• 常用方法: get(), post(), put(), delete(), json(), from(), assertStatus(), assertSee(), assertJson(), assertRedirect()等。

2. 浏览器测试 (Browser Testing) / Laravel Dusk

• 命名空间: 通常位于Tests\Browser。
• 基类: 继承自Laravel\Dusk\TestCase。
• 目的: 模拟用户在真实浏览器中的交互行为。它会启动一个真实的浏览器（如Chrome），执行JavaScript，并测试UI元素、用户流等。适用于需要验证前端交互逻辑的场景。
• 常用方法: visit(), type(), click(), assertSee(), waitFor(), screenshot()等。

解决方案：使用正确的HTTP请求方法

鉴于你的测试文件位于Tests\Feature命名空间下，并且继承自Tests\TestCase，你应该使用功能测试提供的HTTP请求方法。对于访问一个URL并检查其响应，get()方法是正确的选择。

修正后的ExampleTest代码应如下所示：

<?php

namespace Tests\Feature;

use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;

class ExampleTest extends TestCase
{
    // 如果需要数据库刷新，可以启用此trait
    // use RefreshDatabase; 

    /**
     * 一个基本的测试示例。
     *
     * @return void
     */
    public function test_example()
    {
        // 正确的使用方式：使用 get() 方法模拟 HTTP GET 请求
        $response = $this->get('/'); 

        // 验证 HTTP 状态码
        $response->assertStatus(200);

        // 如果需要验证页面内容，可以使用 assertSee()
        // $response->assertSee('Laravel'); 
    }
}

在这个修正后的代码中：

• $this->get('/') 模拟了一个对根URL (/) 的HTTP GET请求。
• $response->assertStatus(200) 验证了响应的HTTP状态码是否为200（成功）。

注意事项与最佳实践

1. 明确测试类型: 在开始编写测试之前，首先明确你正在编写的是功能测试、单元测试还是浏览器测试。这有助于你选择正确的基类和方法。
2. 检查命名空间: 始终检查你的测试文件的命名空间。Tests\Feature通常用于HTTP请求测试，而Tests\Browser则用于Dusk浏览器测试。
3. 查阅官方文档: Laravel的测试文档是最好的资源。对于不同版本的Laravel，测试API可能会有所演变。请务必查阅你当前使用的Laravel版本对应的官方文档（例如Laravel 8的测试文档）。
4. 避免混淆: 不要将Dusk的visit()、type()等方法与Tests\TestCase的功能测试方法混为一谈。它们服务于不同的目的，且由不同的底层实现支持。
5. TDD流程: 在TDD中，先写失败的测试，然后编写最少量的代码使其通过，最后进行重构。理解测试工具的正确使用是高效TDD的基础。

总结

Call to undefined method ...::visit()错误的核心原因在于混淆了Laravel的功能测试与浏览器测试的方法。功能测试（继承自Tests\TestCase）使用get(), post()等方法模拟HTTP请求，而浏览器测试（Laravel Dusk，继承自Laravel\Dusk\TestCase）则使用visit(), type()等方法与真实浏览器交互。通过选择正确的测试类型和相应的方法，开发者可以有效避免这类错误，并编写出准确、高效的Laravel测试用例。

以上就是Laravel测试指南：正确区分功能测试与浏览器测试方法的详细内容，更多请关注php中文网其它相关文章！