当前位置：首页 > 文章列表 > Golang > Go教程 > 测试出站API调用的最佳方法

测试出站API调用的最佳方法

来源：dev.to 2025-02-06 22:15:56 0浏览收藏

哈喽！今天心血来潮给大家带来了《测试出站API调用的最佳方法》，想必大家应该对Golang都不陌生吧，那么阅读本文就都不会很困难，以下内容主要涉及到，若是你正在学习Golang，千万别错过这篇文章~希望能帮助到你！

如今

>日常工作中的另一个重要角色是编写测试。测试确保（或应保证：d）美国编写的所有代码都在其预期方面工作，因此，当该功能在生产环境下运行时，它不会发生任何惊喜。> 因此，很自然地认为，对出站api呼叫的编写测试对于有能力的软件工程师至关重要。在这篇文章中，我想分享一些可以减轻您的测试写作的技术！

因此，第一步是构建将要测试的服务。这真的很简单：我们将称呼pokédexapi（我在pokémontcgpocket hype），并列出所有现有的pokémon。

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
)

type respbody struct {
    results []pokemon `json:"results"`
}

type pokemon struct {
    name string `json:"name"`
}

const url = "https://pokeapi.co"

func main() {
    pkmns, err := fetchpokemon(url)
    if err != nil {
        fmt.println(err)
        return
    }

    for _, pkmn := range pkmns {
        fmt.println(pkmn.name)
    }
}

func fetchpokemon(u string) ([]pokemon, error) {
    r, err := http.get(fmt.sprintf("%s/api/v2/pokemon", u))
    if err != nil {
        return nil, err
    }

    defer r.body.close()
    resp := respbody{}
    err = json.newdecoder(r.body).decode(&resp)
    if err != nil {
        return nil, err
    }

    return resp.results, nil
}

httptest

是go的包裹。它允许创建可以在测试中使用的模拟服务器。它的主要优点是我们不会在项目中添加任何额外的依赖性。但是，它不会自动拦截请求。
>

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
)

type respbody struct {
    results []pokemon `json:"results"`
}

type pokemon struct {
    name string `json:"name"`
}

const url = "https://pokeapi.co"

func main() {
    pkmns, err := fetchpokemon(url)
    if err != nil {
        fmt.println(err)
        return
    }

    for _, pkmn := range pkmns {
        fmt.println(pkmn.name)
    }
}

func fetchpokemon(u string) ([]pokemon, error) {
    r, err := http.get(fmt.sprintf("%s/api/v2/pokemon", u))
    if err != nil {
        return nil, err
    }

    defer r.body.close()
    resp := respbody{}
    err = json.newdecoder(r.body).decode(&resp)
    if err != nil {
        return nil, err
    }

    return resp.results, nil
}

摩卡

摩卡是一个受nock和wiremock启发的自由。它允许检查模拟是否被调用，这是一个不错的功能。像httptest一样，它也不会自动拦截请求。

package main

import (
    "encoding/json"
    "fmt"
    "testing"

    "github.com/stretchr/testify/assert"
    "github.com/vitorsalgado/mocha/v3"
    "github.com/vitorsalgado/mocha/v3/expect"
    "github.com/vitorsalgado/mocha/v3/reply"
)

func test_mocha(t *testing.t) {
    j, err := json.marshal(respbody{results: []pokemon{{name: "charizard"}}})
    assert.nil(t, err)

    m := mocha.new(t)
    m.start()

    scoped := m.addmocks(mocha.get(expect.urlpath("/api/v2/pokemon")).
        reply(reply.ok().bodystring(string(j))))

    p, err := fetchpokemon(m.url())
    fmt.println(m.url())
    assert.nil(t, err)
    assert.true(t, scoped.called())
    assert.equal(t, p[0].name, "charizard")
}

戈克

>另一个不错的选择是gock，gock，它也受到nock的启发，具有简单简单的api。它可以通过拦截任何http.client提出的http请求并将其添加到列表中，从而可以检查是否存在模拟请求。如果没有，则返回错误，除非真正的网络模式打开。在这种情况下，请求正常完成。

package main

import (
    "encoding/json"
    "testing"

    "github.com/h2non/gock"
    "github.com/stretchr/testify/assert"
)

func test_gock(t *testing.t) {
    defer gock.off()

    j, err := json.marshal(respbody{results: []pokemon{{name: "charizard"}}})
    assert.nil(t, err)

    gock.new("https://pokeapi.co").
        get("/api/v2/pokemon").
        reply(200).
        json(j)

    p, err := fetchpokemon(url)
    assert.nil(t, err)
    assert.equal(t, p[0].name, "charizard")
}

apitest

终于，apitest是受gock启发的lib，具有无限匹配者和功能。它还允许用户构建其http调用的序列图。很酷的事情是他们出色的网站，有很多例子。

package main

import (
    "encoding/json"
    "net/http"
    "testing"

    "github.com/steinfletcher/apitest"
    "github.com/stretchr/testify/assert"
)

func Test_APItest(t *testing.T) {
    j, err := json.Marshal(RespBody{Results: []Pokemon{{Name: "Charizard"}}})
    assert.Nil(t, err)

    defer apitest.NewMock().
        Get("https://pokeapi.co/api/v2/pokemon").
        RespondWith().
        Body(string(j)).
        Status(http.StatusOK).
        EndStandalone()()

    p, err := FetchPokemon(URL)
    assert.Nil(t, err)
    assert.Equal(t, p[0].Name, "Charizard")
}

minetto 关于此lib的文章很棒！值得检查！
结论