Тестирование интеграции CAPTCHA на Go без расходования средств

1. 1.

   Установите зависимость

   Используйте Go 1.22 или новее. В своём модуле Go установите solvethree.com/[email protected] с помощью go get. Модуль доступен на solvethree.com.

2. 2.

   Сохранение и запуск теста

   Сохраните пример как captcha_integration_test.go в каталоге вашего модуля, предназначенном только для тестов, затем выполните go test из этого каталога. Не меняйте ключ, имя хоста и прокси в заглушке: это тестовые данные, а не учётные данные или сервисы, которые нужно настраивать.

package integration_test

import (
    "context"
    "fmt"
    "net/http"
    "net/http/httptest"
    "sync/atomic"
    "testing"
    "time"
    solvethree "solvethree.com/sdk"
)

func TestSolve(t *testing.T) {
    var posts atomic.Int32
    server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        w.Header().Set("Content-Type", "application/json")
        if r.Method == "POST" {
            posts.Add(1)
            fmt.Fprint(w, `{"id":"fixture-1","status":"pending"}`)
            return
        }
        fmt.Fprint(w, `{"id":"fixture-1","status":"ready","solution":{"token":"FIXTURE_TOKEN","userAgent":"fixture-browser-identity","secChUa":"fixture-hints"}}`)
    }))
    defer server.Close()
    client, err := solvethree.NewClientWithBaseURL("fixture-key", server.URL, nil)
    if err != nil { t.Fatal(err) }
    result, err := client.Solve(context.Background(), solvethree.TaskRequest{
        Site: "accounts.example.com", Action: "login", Proxy: "http://proxy.example:8080",
    }, solvethree.SolveOptions{Timeout: time.Second, PollInterval: time.Millisecond})
    if err != nil { t.Fatal(err) }
    if result.Solution.Token != "FIXTURE_TOKEN" || posts.Load() != 1 { t.Fatal("incorrect lifecycle") }
}

NewClientWithBaseURL допускает HTTP через loopback для тестов. Здесь server.URL заменяет адрес рабочего API, а обработчик отвечает локально. Значение прокси — лишь часть отправленной задачи; заглушка к нему не подключается.

Ответ на POST оставляет задачу в ожидании. Следующий запрос получает ответ о готовности, содержащий FIXTURE_TOKEN. Финальная проверка проверяет и возвращённый токен, и наличие ровно одного POST, выявляя случайное создание дополнительной задачи в этом процессе.

Обработчик намеренно упрощён: любой запрос, кроме POST, получает ответ о готовности. Он не проверяет метод опроса, путь запроса или отправленный JSON. Чтобы также проверить контракт запросов, добавьте в обработчик проверку ожидаемых маршрутов создания и получения задачи, а также переданных сайта, действия и прокси.

Успешное прохождение теста подтверждает работу смоделированного жизненного цикла SDK. Оно не проверяет реальный профиль сайта, прокси или принятие токена целевым сервисом. Возвращённый токен и идентификационные данные браузера — тестовые значения.

Расширьте локальный обработчик, чтобы он возвращал состояния, которые должно обрабатывать ваше приложение. Сохраните счётчик POST: повторный опрос не должен создавать ещё одну задачу.

Для сценария потери ответа явно задайте в тесте идентификатор запроса и настройте заглушку так, чтобы при повторной отправке этого идентификатора и тех же входных данных она возвращала существующую задачу. Иначе вы проверяете второе создание, а не восстановление.