Skip to content

Latest commit

 

History

History
 
 

testing

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
iotest
iotest
 
 
quick
quick
 
 
B.md
B.md
 
 
B_Error.md
B_Error.md
 
 
B_Errorf.md
B_Errorf.md
 
 
B_Fail.md
B_Fail.md
 
 
B_FailNow.md
B_FailNow.md
 
 
B_Failed.md
B_Failed.md
 
 
B_Fatal.md
B_Fatal.md
 
 
B_Fatalf.md
B_Fatalf.md
 
 
B_Log.md
B_Log.md
 
 
B_Logf.md
B_Logf.md
 
 
B_ResetTimer.md
B_ResetTimer.md
 
 
B_SetBytes.md
B_SetBytes.md
 
 
B_StartTimer.md
B_StartTimer.md
 
 
B_StopTimer.md
B_StopTimer.md
 
 
Benchmark.md
Benchmark.md
 
 
BenchmarkResult.md
BenchmarkResult.md
 
 
BenchmarkResult_NsPerOp.md
BenchmarkResult_NsPerOp.md
 
 
BenchmarkResult_String.md
BenchmarkResult_String.md
 
 
InternalBenchmark.md
InternalBenchmark.md
 
 
InternalExample.md
InternalExample.md
 
 
InternalTest.md
InternalTest.md
 
 
Main.md
Main.md
 
 
README.md
README.md
 
 
RunBenchmarks.md
RunBenchmarks.md
 
 
RunExamples.md
RunExamples.md
 
 
RunTests.md
RunTests.md
 
 
Short.md
Short.md
 
 
T.md
T.md
 
 
T_Error.md
T_Error.md
 
 
T_Errorf.md
T_Errorf.md
 
 
T_Fail.md
T_Fail.md
 
 
T_FailNow.md
T_FailNow.md
 
 
T_Failed.md
T_Failed.md
 
 
T_Fatal.md
T_Fatal.md
 
 
T_Fatalf.md
T_Fatalf.md
 
 
T_Log.md
T_Log.md
 
 
T_Logf.md
T_Logf.md
 
 
T_Parallel.md
T_Parallel.md
 
 

README.md

testing包

testing包为go的代码包提供自动化测试支持。它的目标是与“go test”命令协同使用，以自动执行form的任何函数。

func TestXxx(*testing.T)

Xxx可以使任何字母和数字组合的字符串（但是第一个字符必须是a-z的）并且在测试程序中时唯一的。这些TestXxx程序应该在包中声明他们是用来测试的。

form的函数

func BenchmarkXxx(*testing.B)

用来做基准测试，并且执行“go test -test.bench”命令后会启动这些测试。

一个简单的基准测试就像这样：

func BenchmarkHello(b *testing.B) {
    for i := 0; i < b.N; i++ {
        fmt.Sprintf("hello")
    }
}

基准测试包将会执行不同的 b.N 次直到基准测试函数可靠运行了足够长的时间。下面的输出：

testing.BenchmarkHello    10000000    282 ns/op

意味着基准测试函数testing.BenchmarkHello()循环跑了10000000次，并且单次循环平均耗时 282 纳秒。

func BenchmarkBigLen(b *testing.B) {
    b.StopTimer()
    big := NewBig()
    b.StartTimer()
    for i := 0; i < b.N; i++ {
        big.Len()
    }
}

此包也可以运行和验证示例代码。示例测试函数可以包含结论注释语句，该语句以“Output:”开头，并当测试运行结束时标准输出会与这一注释语句相比较，下面是示例测试函数的例子：

func ExampleHello() {
    fmt.Println("hello")
    // Output: hello
}

func ExampleSalutations() {
        fmt.Println("hello, and")
        fmt.Println("goodbye")
        // Output:
        // hello, and
        // goodbye
}

没有输出注释语句的示例测试函数会被编译但不会被执行。

为函数 F、类型 T 以及类型 T 上的方法 M 声明示例测试函数的命名规则是这样的：

func ExampleF() { ... }
func ExampleT() { ... }
func ExampleT_M() { ... }

为一个类型或函数或方法编写多个示例测试函数时可以直接在函数名称上加上不同的后缀。后缀必须以小写字母开头。

func ExampleF_suffix() { ... }
func ExampleT_suffix() { ... }
func ExampleT_M_suffix() { ... }

只要测试文件中有示例测试函数，它就需要被明示是一个示例测试文件。这个示例测试文件可以包含其他函数、类型变量或常量声明，但不能有普通测试函数和基准测试函数。

testing包函数列表