Iris 为 httpexpect (一个web测试框架) 提供了丰富的支持。iris/httptest 子包为 iris + httpexpect 提供了帮助。

如果你更喜欢 golang 的 net/http/httptest 标准库，你也可以使用它。Iris 尽可能与其它外部测试工具兼容。

基本认证(Basic Authentication)

在第一个示例中，我们使用 iris/httptest 来测试权限验证。

  1. main.go 文件像这样：
  1. package main
  3. import (
  4.     "github.com/kataras/iris/v12"
  5.     "github.com/kataras/iris/v12/middleware/basicauth"
  6. )
  8. func newApp() *iris.Application {
  9.     app := iris.New()
  11.     authConfig := basicauth.Config{
  12.         Users: map[string]string{"myusername": "mypassword"},
  13.     }
  15.     authentication := basicauth.New(authConfig)
  17.     app.Get("/", func(ctx iris.Context) { ctx.Redirect("/admin") })
  19.     needAuth := app.Party("/admin", authentication)
  20.     {
  21.         //http://localhost:8080/admin
  22.         needAuth.Get("/", h)
  23.         // http://localhost:8080/admin/profile
  24.         needAuth.Get("/profile", h)
  26.         // http://localhost:8080/admin/settings
  27.         needAuth.Get("/settings", h)
  28.     }
  30.     return app
  31. }
  33. func h(ctx iris.Context) {
  34.     username, password, _ := ctx.Request().BasicAuth()
  35.     // third parameter  ^ will be always true because the middleware
  36.     // makes sure for that, otherwise this handler will not be executed.
  38.     ctx.Writef("%s %s:%s", ctx.Path(), username, password)
  39. }
  41. func main() {
  42.     app := newApp()
  43.     app.Run(iris.Addr(":8080"))
  44. }
  1. 现在，创建一个 main_test.go 文件，然后复制下面的代码：
  1. package main
  3. import (
  4.     "testing"
  6.     "github.com/kataras/iris/v12/httptest"
  7. )
  9. func TestNewApp(t *testing.T) {
  10.     app := newApp()
  11.     e := httptest.New(t, app)
  13.     // redirects to /admin without basic auth
  14.     e.GET("/").Expect().Status(httptest.StatusUnauthorized)
  15.     // without basic auth
  16.     e.GET("/admin").Expect().Status(httptest.StatusUnauthorized)
  18.     // with valid basic auth
  19.     e.GET("/admin").WithBasicAuth("myusername", "mypassword").Expect().
  20.         Status(httptest.StatusOK).Body().Equal("/admin myusername:mypassword")
  21.     e.GET("/admin/profile").WithBasicAuth("myusername", "mypassword").Expect().
  22.         Status(httptest.StatusOK).Body().Equal("/admin/profile myusername:mypassword")
  23.     e.GET("/admin/settings").WithBasicAuth("myusername", "mypassword").Expect().
  24.         Status(httptest.StatusOK).Body().Equal("/admin/settings myusername:mypassword")
  26.     // with invalid basic auth
  27.     e.GET("/admin/settings").WithBasicAuth("invalidusername", "invalidpassword").
  28.         Expect().Status(httptest.StatusUnauthorized)
  30. }
  1. 打开你的命令行然后执行：
  1. $ go test -v

其他示例

  1. package main
  3. import (
  4.     "fmt"
  5.     "testing"
  7.     "github.com/kataras/iris/v12/httptest"
  8. )
  10. func TestCookiesBasic(t *testing.T) {
  11.     app := newApp()
  12.     e := httptest.New(t, app, httptest.URL("http://example.com"))
  14.     cookieName, cookieValue := "my_cookie_name", "my_cookie_value"
  16.     // Test Set A Cookie.
  17.     t1 := e.GET(fmt.Sprintf("/cookies/%s/%s", cookieName, cookieValue)).
  18.         Expect().Status(httptest.StatusOK)
  19.     // Validate cookie's existence, it should be available now.
  20.     t1.Cookie(cookieName).Value().Equal(cookieValue)
  21.     t1.Body().Contains(cookieValue)
  23.     path := fmt.Sprintf("/cookies/%s", cookieName)
  25.     // Test Retrieve A Cookie.
  26.     t2 := e.GET(path).Expect().Status(httptest.StatusOK)
  27.     t2.Body().Equal(cookieValue)
  29.     // Test Remove A Cookie.
  30.     t3 := e.DELETE(path).Expect().Status(httptest.StatusOK)
  31.     t3.Body().Contains(cookieName)
  33.     t4 := e.GET(path).Expect().Status(httptest.StatusOK)
  34.     t4.Cookies().Empty()
  35.     t4.Body().Empty()
  36. }
  1. $ go test -v -run=TestCookiesBasic$