wacat - 一款开源随机测试工具

测试界的海飞丝2024-09-08 0:38

想象一下，你离开电脑一会儿去拿一杯咖啡。与此同时，你的猫走过键盘，引发了一些混乱。

wacat 应用程序：

  • • 访问你的网页应用的根网址

  • • 随机访问应用中的每个链接

  • • 在表单中添加随机文本输入

  • • 从下拉菜单、复选框等中选择随机值

  • • 随机顺序点击每个按钮

此外，wacat 还可以：

  • • 检测浏览器与服务器之间的 HTTP 错误（例如 HTTP 500 错误）

  • • 检测浏览器控制台日志中的错误

  • • 从网页中检测错误字符串

    • • 你可以在参数文件中提供错误字符串

  • • 支持用户配置随机表单文本输入

  • • 可以从外部文件读取表单输入

  • • 可以仅测试链接，这可以用于应用程序的烟雾测试

  • • 支持某些身份验证场景

    • • 你可以在 JSON 文件中提供身份验证配置

  • • 支持配置不访问的页面

  • • 支持无头模式

  • • 支持配置页面下载等待时间和整个测试的超时值

  • • 支持在 CI 管道中运行

wacat 内部使用 Playwright[1] 工具。wacat 已经过测试，可在 Windows、Linux 和 Mac 上运行。

如果你发现了 bug 或需要某些特定功能，请创建一个新的 issue。

当前 wacat 版本为 1.1.2。请查看本页末尾以查看更改历史。

警告

请仅测试您自己的网页应用程序，或获得测试他人应用程序的许可。在未经许可的情况下测试他人应用程序的漏洞可能是违法的。

由于这是我的业余项目，一切皆有可能，最好密切关注 wacat 应用程序的行为，如果它访问了错误的页面，请使用 ctrl + c 停止。请注意，如果您的应用程序使用身份验证，而您的 wacat 身份验证配置不正确或 wacat 不适用于您的情况，那么您的帐户可能会被锁定或出现类似问题。此外，wacat 可能会扰乱您的应用程序数据库等。因此，最好仅在测试环境中进行测试。

安装

安装 Node.js

安装 Node.js 官方指引[2]

克隆 wacat 并安装

克隆 wacat，进入 wacat 目录并且运行：

npm install && npx playwright install --with-deps && npm run build && npm i -g

注意：由于 Playwright 工具是全局安装的，因此在运行前面的命令时可能会要求输入密码。

更新 wacat

更新 wacat 版本的指令：

git pull && npm install && npx playwright install --with-deps && npm run build && npm i -g

运行

Basic running

在 wacat 文件夹中运行以下命令：

wacat test <your url>

例如：

wacat test https://mikesmallhelp-test-application.vercel.app/

在 URL https://mikesmallhelp-test-application.vercel.app/ 中测试一个简单的应用程序。该应用程序包含以下页面：

首先，wacat 应用程序会打开 Chromium 浏览器并访问命令中提供的根 URL：

根页面不包含任何输入字段、下拉菜单等。wacat 简单地收集两个子页面的链接并访问它们。在每个子页面中，wacat 首先点击按钮，然后填写表单输入，选择下拉菜单项等，最后再次点击按钮。以下是您可以复制、粘贴并运行的命令。同样，您可以运行所有其他示例，并请随意使用我的测试应用程序。

wacat test https://mikesmallhelp-test-application.vercel.app/
复制代码

  1. Testing in url: https://mikesmallhelp-test-application.vercel.app/. Please wait...

  4. Running 1 test using 1 worker

  5. [chromium] › test.spec.ts:41:1 › test an application

  6. In the page: https://mikesmallhelp-test-application.vercel.app/

  7. In the page: https://mikesmallhelp-test-application.vercel.app/working-page2

  8. Push the button #1

  9. Filling the #1 text input field a value: _k6AKNU3z"{=myqS.K

  10. The label is 'Your Date of Birth Here', so generating an appropriate random content for the input field

  11. Filling the #2 text input field a value: 16/09/2004

  12. The #1 drop-down list. Selecting the option #2

  13. Selecting the #1 checkbox

  14. The #1 radio button group. Selecting the radio button #3

  15. Filling the #1 email input field a value: pvcgigtju.nwntltbk@uqimkbwwiz.com

  16. Filling the #1 password input field a value: A#1!!a#!#AaA!A

  17. Filling the #1 search input field a value: SZOmqATkrV

  18. Filling the #1 url input field a value: https://nrebn.com

  19. Push the button #1

  20. In the page: https://mikesmallhelp-test-application.vercel.app/working-page

  21. Push the button #1

  22. Filling the #1 text input field a value: _k6AKNU3z"{=myqS.K

  23. The label is 'Your Date of Birth Here', so generating an appropriate random content for the input field

  24. Filling the #2 text input field a value: 16/09/2004

  25. The #1 drop-down list. Selecting the option #2

  26. Selecting the #1 checkbox

  27. The #1 radio button group. Selecting the radio button #2

  28. Filling the #1 email input field a value: uxxdxqcjhq.mhettm@ukyefgvdsk.gov

  29. Filling the #1 password input field a value: aa2B#1aA!##2A#!AaA

  30. Filling the #1 search input field a value: lSjsBVOzkhCC

  31. Filling the #1 url input field a value: https://vpo7ut.net

  32. Push the button #1

  33. 1 passed (24.3s)

请注意，输出包含"1 passed"，因此 wacat 没有在应用程序中发现任何错误。另外，请注意，每个页面的默认等待时间为 5000 毫秒。如果您想更改此时间，请使用 --wait 标志（详见后文）。

检测 HTTP 错误

wacat 可以检测浏览器和服务器之间的 HTTP 错误。例如，如果在下面的示例应用程序中点击按钮，会出现 HTTP 500 错误。

例如：

wacat test https://mikesmallhelp-test-application-http-500-error.vercel.app/
复制代码

  1. Testing in url: https://mikesmallhelp-test-application-http-500-error.vercel.app/. Please wait...

  3. › Error:

  4. › Error occurred: Command failed: ROOT_URL='https://mikesmallhelp-test-application-http-500-error.vercel.app/' npx playwright test --project=chromium --headed

  5. › + stderr: + stdout:

  6. › Running 1 test using 1 worker

  7. [chromium] › test.spec.ts:40:1 › test an application

  8. › In the page: https://mikesmallhelp-test-application-http-500-error.vercel.app/

  9. In the page: https://mikesmallhelp-test-application-http-500-error.vercel.app/working-page

  10. Push the button #1

  11. Filling the #1 text input field a value: 4trK*edD

  12. The #1 drop-down list. Selecting the option #2

  13. Push the button #1

  14. In the page: https://mikesmallhelp-test-application-http-500-error.vercel.app/api-returns-http-500

  15. Push the button #1

  16. In the page: https://mikesmallhelp-test-application-http-500-error.vercel.app/api-returns-http-500: Request to https://mikesmallhelp-test-application-http-500-error.vercel.app/api/http-500 resulted

  17. › in status code 500

  18. In the page: https://mikesmallhelp-test-application-http-500-error.vercel.app/api-returns-http-500: Found an error message in the browser's console: Failed to load resource: the server responded

  19. › with a status of 500 ()

  20. In the page: https://mikesmallhelp-test-application-http-500-error.vercel.app/api-returns-http-500: Found an error message in the browser's console: Error fetching data: Error: Network response was

  21. › not ok

  22. › at r (https://mikesmallhelp-test-application-http-500-error.vercel.app/_next/static/chunks/pages/api-returns-http-500-d6a108dd102494f7.js:1:1402)

  23. › at async n (https://mikesmallhelp-test-application-http-500-error.vercel.app/_next/static/chunks/pages/api-returns-http-500-d6a108dd102494f7.js:1:735)

  24. 1) [chromium] › test.spec.ts:40:1 › test an application ──────────────────────────────────────────

  25. ›

  26. › AssertionError: In the page: https://mikesmallhelp-test-application-http-500-error.vercel.app/api-returns-http-500: Request to

  27. › https://mikesmallhelp-test-application-http-500-error.vercel.app/api/http-500 resulted in status code 500

  28. ›

  29. › 51 |

  30. › 52 | if (!bypassHttpErrors) {

  31. › > 53 | fail(message);

  32. › | ^

  33. › 54 | }

  34. › 55 | }

  35. › 56 | });

  36. ›

  37. › at Page.<anonymous> (/home/lenovo/projektit/wacat/e2e-tests/test.spec.ts:53:17)

  38. ›

  39. 1 failed

  40. › [chromium] › test.spec.ts:40:1 › test an application

因此，wacat 会检测到 HTTP 500 错误，打印错误日志，显示文本 "1 failed" 并停止执行。具体的错误信息是：

复制代码

  1. AssertionError: In the page: https://mikesmallhelp-test-application-http-500-error.vercel.app/api-returns-http-500: Request to

  2. › https://mikesmallhelp-test-application-http-500-error.vercel.app/api/http-500 resulted in status code 500

如果您想绕过 HTTP 错误时停止执行的行为，请使用 --bypass-http-errors 标志。例如，以下命令：

wacat test --bypass-http-errors https://mikesmallhelp-test-application-http-500-error.vercel.app/

执行不会像上一个示例那样因 HTTP 500 错误而停止。wacat 会将 HTTP 500 错误打印到日志中，但执行会继续进行。

从目标应用程序的页面检测错误字符串

这是一个示例应用程序，其中一个子页面包含错误文本 "Error occurred!"：

在我们的示例中，我们配置 wacat 检测到 "Error occurred!"。我们还希望检测到错误文本 "abc"。我们在 JSON 文件中进行如下配置：

复制代码

  1. {

  2. "errorTextsInPages": ["abc", "Error occurred!"]

  3. }

在 Windows 上运行命令（使用 --conf 标志传递 JSON 文件）：

wacat test --conf example-files\configuration-error-texts.json https://mikesmallhelp-test-application-error-in-page.vercel.app

在 Linux 和 Mac上运行命令：

wacat test --conf example-files/configuration-error-texts.json https://mikesmallhelp-test-application-error-in-page.vercel.app

命令的输出是：

复制代码

  1. Testing in url: https://mikesmallhelp-test-application-error-in-page.vercel.app. Please wait...

  3. › Error:

  4. › Error occurred: Command failed: ROOT_URL='https://mikesmallhelp-test-application-error-in-page.vercel.app' CONFIGURATION_FILE_PATH=example-files/configuration-error-texts.json WAIT=2000 npx

  5. › playwright test --project=chromium --headed

  6. › + stderr: + stdout:

  7. › Running 1 test using 1 worker

  8. [chromium] › test.spec.ts:40:1 › test an application

  9. › In the page: https://mikesmallhelp-test-application-error-in-page.vercel.app/

  10. Check the page not contain the abc text

  11. Check the page not contain the Error occurred! text

  12. In the page: https://mikesmallhelp-test-application-error-in-page.vercel.app/error-text-in-page

  13. Check the page not contain the abc text

  14. Check the page not contain the Error occurred! text

  15. 1) [chromium] › test.spec.ts:40:1 › test an application ──────────────────────────────────────────

  16. ›

  17. › Error: expect(received).not.toContain(expected) // indexOf

  18. ›

  19. › Expected substring: not "Error occurred!"

  20. › Received string: "Test page - error-text-in-pageError occurred!{\"props\":{\"pageProps\":{}},\"page\":\"/error-text-in-page\",\"query\":{},\"buildId\":\"MVBwm9bMplVdAQ-ZjLXZ5\",\"nextExp

  21. › ort\":true,\"autoExport\":true,\"isFallback\":false,\"scriptLoader\":[]}"

  22. ›

  23. › 150 | for (const errorText of configuration.errorTextsInPages) {

  24. › 151 | console.log(`Check the page not contain the ${errorText} text`);

  25. › > 152 | expect(content).not.toContain(errorText);

  26. › | ^

  27. › 153 | }

  28. › 154 | }

  29. › 155 |

  30. ›

  31. › at checkPageForErrors (/home/lenovo/projektit/wacat/e2e-tests/test.spec.ts:152:29)

  32. › at handlePage (/home/lenovo/projektit/wacat/e2e-tests/test.spec.ts:122:5)

  33. › at visitLinks (/home/lenovo/projektit/wacat/e2e-tests/test.spec.ts:398:13)

  34. › at handlePage (/home/lenovo/projektit/wacat/e2e-tests/test.spec.ts:132:5)

  35. › at /home/lenovo/projektit/wacat/e2e-tests/test.spec.ts:73:5

  36. ›

  37. 1 failed

  38. › [chromium] › test.spec.ts:40:1 › test an application

wacat 在一个子页面中检测到 "Error occurred!" 文本，报告错误并显示 "1 failed" 文本，执行停止。

检测浏览器控制台中的错误

这是一个示例应用程序，其中包含在浏览器控制台中的错误日志记录：

示例命令

wacat test https://mikesmallhelp-test-application-error-in-browser-console.vercel.app

执行停止在浏览器控制台中的错误日志记录处：

复制代码

  1. Testing in url: https://mikesmallhelp-test-application-error-in-browser-console.vercel.app. Please wait...

  3. › Error:

  4. › Error occurred: Command failed: ROOT_URL='https://mikesmallhelp-test-application-error-in-browser-console.vercel.app' WAIT=2000 npx playwright test --project=chromium --headed

  5. › + stderr: + stdout:

  6. › Running 1 test using 1 worker

  7. [chromium] › test.spec.ts:40:1 › test an application

  8. › In the page: https://mikesmallhelp-test-application-error-in-browser-console.vercel.app/

  9. In the page: https://mikesmallhelp-test-application-error-in-browser-console.vercel.app/working-page

  10. Push the button #1

  11. Filling the #1 text input field a value: q52<<r`k`bZzP<Jua#53RAn)cKg0&K14

  12. The #1 drop-down list. Selecting the option #2

  13. Push the button #1

  14. In the page: https://mikesmallhelp-test-application-error-in-browser-console.vercel.app/error-in-browser-console: Found an error message in the browser's console: Hello! Something wrong!

  15. 1) [chromium] › test.spec.ts:40:1 › test an application ──────────────────────────────────────────

  16. ›

  17. › AssertionError: In the page: https://mikesmallhelp-test-application-error-in-browser-console.vercel.app/error-in-browser-console: Found an error message in the browser's console: Hello!

  18. › Something wrong!

  19. ›

  20. › 62 |

  21. › 63 | if (!bypassBrowserConsoleErrors && !bypassHttpErrors) {

  22. › > 64 | fail(message);

  23. › | ^

  24. › 65 | }

  25. › 66 | }

  26. › 67 | });

  27. ›

  28. › at Page.<anonymous> (/home/lenovo/projektit/wacat/e2e-tests/test.spec.ts:64:17)

  29. ›

  30. 1 failed

  31. › [chromium] › test.spec.ts:40:1 › test an application

wacat 打印消息 "Found an error message in the browser's console: Hello! Something wrong!" 并停止执行。

如果您想绕过此检查并继续执行，请使用 --bypass-browser-console-errors 标志。以下命令：

wacat test --bypass-browser-console-errors https://mikesmallhelp-test-application-error-in-browser-console.vercel.app

不会像上一个示例那样停止。wacat 会记录错误消息，但继续执行。

配置随机表单输入

通常，wacat 会生成随机的表单输入。默认情况下，长度在 1 到 60 个字符之间，并使用默认字符集。使用 --random-input-texts-min-length 标志指定最小长度，使用 --random-input-texts-max-length 标志指定最大长度。使用 --random-input-texts-charset 标志指定字符集。示例命令和输出如下：

wacat test --random-input-texts-min-length 1 --random-input-texts-max-length 3 --random-input-texts-charset ®©¥¬¿ https://mikesmallhelp-test-application.vercel.app/
复制代码

  1. Testing in url: https://mikesmallhelp-test-application.vercel.app/. Please wait...

  4. Running 1 test using 1 worker

  5. [chromium] › test.spec.ts:41:1 › test an application

  6. In the page: https://mikesmallhelp-test-application.vercel.app/

  7. In the page: https://mikesmallhelp-test-application.vercel.app/working-page

  8. Push the button #1

  9. Filling the #1 text input field a value: ®

  10. Filling the #2 text input field a value: ®

  11. Filling the #3 text input field a value: ®

  12. Filling the #4 text input field a value: ®

  13. Filling the #5 text input field a value: ®

  14. Filling the #6 text input field a value: ®

  15. The #1 drop-down list. Selecting the option #2

  16. Selecting the #1 checkbox

  17. The #1 radio button group. Selecting the radio button #3

  18. Push the button #1

  19. In the page: https://mikesmallhelp-test-application.vercel.app/working-page2

  20. Push the button #1

  21. Filling the #1 text input field a value: ®

  22. Filling the #2 text input field a value: ®

  23. Filling the #3 text input field a value: ®

  24. Filling the #4 text input field a value: ®

  25. Filling the #5 text input field a value: ®

  26. Filling the #6 text input field a value: ®

  27. The #1 drop-down list. Selecting the option #2

  28. Selecting the #1 checkbox

  29. The #1 radio button group. Selecting the radio button #2

  30. Push the button #1

  31. 1 passed (54.0s)

在这个示例中，wacat 生成随机字符串 ®，长度在 1 到 3 个字符之间，字符来自指定的字符集 ®©¥¬¿。

从文件读取输入字段文本

此外，还可以从文件中读取输入字段，例如从文件 example-files/input.texts，内容如下：

复制代码

  1. xaxa

  2. ybyb

wacat 使用文件中的每个输入文本填充目标应用程序中的每个输入字段，除非发生错误或页面变化。对于本地文件，在 Windows 上运行的命令为：

wacat test --input-texts example-files\input-texts.txt https://mikesmallhelp-test-application.vercel.app/

在 Linux 和 Mac 上:

wacat test --input-texts example-files/input-texts.txt https://mikesmallhelp-test-application.vercel.app/

对于远程文件：

wacat test --input-texts https://raw.githubusercontent.com/mikesmallhelp/wacat/main/example-files/input-texts.txt https://mikesmallhelp-test-application.vercel.app/

所有的指令输出为：

复制代码

  1. Testing in url: https://mikesmallhelp-test-application.vercel.app/. Please wait...

  3. Running 1 test using 1 worker

  4. [chromium] › test.spec.ts:41:1 › test an application

  5. In the page: https://mikesmallhelp-test-application.vercel.app/

  6. In the page: https://mikesmallhelp-test-application.vercel.app/working-page

  7. Push the button #1

  8. Filling the #1 text input field a value: xaxa

  9. Filling the #2 text input field a value: xaxa

  10. Filling the #3 text input field a value: xaxa

  11. Filling the #4 text input field a value: xaxa

  12. Filling the #5 text input field a value: xaxa

  13. Filling the #6 text input field a value: xaxa

  14. The #1 drop-down list. Selecting the option #2

  15. Selecting the #1 checkbox

  16. The #1 radio button group. Selecting the radio button #3

  17. Push the button #1

  18. Filling the #1 text input field a value: ybyb

  19. Filling the #2 text input field a value: ybyb

  20. Filling the #3 text input field a value: ybyb

  21. Filling the #4 text input field a value: ybyb

  22. Filling the #5 text input field a value: ybyb

  23. Filling the #6 text input field a value: ybyb

  24. The #1 drop-down list. Selecting the option #2

  25. Selecting the #1 checkbox

  26. The #1 radio button group. Selecting the radio button #1

  27. Push the button #1

  28. In the page: https://mikesmallhelp-test-application.vercel.app/working-page2

  29. Push the button #1

  30. Filling the #1 text input field a value: xaxa

  31. Filling the #2 text input field a value: xaxa

  32. Filling the #3 text input field a value: xaxa

  33. Filling the #4 text input field a value: xaxa

  34. Filling the #5 text input field a value: xaxa

  35. Filling the #6 text input field a value: xaxa

  36. The #1 drop-down list. Selecting the option #2

  37. Selecting the #1 checkbox

  38. The #1 radio button group. Selecting the radio button #1

  39. Push the button #1

  40. Filling the #1 text input field a value: ybyb

  41. Filling the #2 text input field a value: ybyb

  42. Filling the #3 text input field a value: ybyb

  43. Filling the #4 text input field a value: ybyb

  44. Filling the #5 text input field a value: ybyb

  45. Filling the #6 text input field a value: ybyb

  46. The #1 drop-down list. Selecting the option #2

  47. Selecting the #1 checkbox

  48. The #1 radio button group. Selecting the radio button #3

  49. Push the button #1

  50. 1 passed (1.1m)

在输出中，您可以看到使用了 input-texts.txt 文件中的值。您可以使用不同的输入文本文件进行测试，例如来自页面 https://github.com/0xspade/Combined-Wordlists?tab=readme-ov-file 的文件。当您使用大输入文本文件时，请使用 --timeout 参数（详见下文），并设置足够大的值。

仅测试链接

要仅测试应用程序中的链接，请使用 --only-links 标志。此时，wacat 会加载页面并检测 HTTP 错误，但不会填写输入字段等。示例命令和输出如下：

wacat test --only-links https://mikesmallhelp-test-application.vercel.app/
复制代码

  1. Testing in url: https://mikesmallhelp-test-application.vercel.app/. Please wait...

  4. Running 1 test using 1 worker

  5. [chromium] › test.spec.ts:40:1 › test an application

  6. In the page: https://mikesmallhelp-test-application.vercel.app/

  7. In the page: https://mikesmallhelp-test-application.vercel.app/working-page

  8. In the page: https://mikesmallhelp-test-application.vercel.app/working-page2

  9. 1 passed (14.7s)

登录验证

这是一个带有简单身份验证的应用程序：

wacat 可以使用以下 JSON 文件对该应用程序进行身份验证：

复制代码

  1. {

  2. "authentication": {

  3. "usernameLabel": "Username",

  4. "usernameValue": "Mike",

  5. "passwordLabel": "Password",

  6. "passwordValue": "Smallhelp",

  7. "loginButtonLabel": "Login"

  8. }

  9. }

请注意，例如该应用程序包含 "Username" 标签，这个标签被放入 JSON 中 "usernameLabel" 属性的值中。用户名值为 "Mike"，被放入 JSON 中 "usernameValue" 属性的值中。同样的逻辑适用于密码输入字段。应用程序有一个名为 "Login" 的按钮，被放入 JSON 中 "loginButtonLabel" 属性的值中。

在 Windows 上的示例运行命令为：

wacat test --conf example-files\configuration-authentication.json https://mikesmallhelp-test-application-simple-authentication.vercel.app/

在 Linux 和 Mac 运行:

wacat test --conf example-files/configuration-authentication.json https://mikesmallhelp-test-application-simple-authentication.vercel.app/

命令的输出为：

复制代码

  1. Testing in url: https://mikesmallhelp-test-application-simple-authentication.vercel.app/. Please wait...

  4. Running 1 test using 1 worker

  5. [chromium] › test.spec.ts:40:1 › test an application

  6. Filled the username and the password. Pushed the authentication button

  7. In the page: https://mikesmallhelp-test-application-simple-authentication.vercel.app/

  8. In the page: https://mikesmallhelp-test-application-simple-authentication.vercel.app/working-page2

  9. Push the button #1

  10. Filling the #1 text input field a value: =_e6PF[J{u98&QI`DP

  11. The #1 drop-down list. Selecting the option #2

  12. Push the button #1

  13. In the page: https://mikesmallhelp-test-application-simple-authentication.vercel.app/working-page

  14. Push the button #1

  15. Filling the #1 text input field a value: =_e6PF[J{u98&QI`DP

  16. The #1 drop-down list. Selecting the option #2

  17. Push the button #1

  18. 1 passed (24.7s)

请注意输出中的文本 "Filled the username and the password. Pushed the authentication button"，这意味着 wacat 已完成身份验证。

进行更复杂的身份验证

这是一个具有更复杂身份验证的应用程序：

wacat 可以使用以下 JSON 文件对该应用程序进行身份验证：

复制代码

  1. {

  2. "authentication": {

  3. "beforeAuthenticationLinkTexts": [

  4. "Please go to an application",

  5. "Please login"

  6. ],

  7. "usernameLabel": "Username",

  8. "usernameValue": "Mike",

  9. "usernameButtonLabel": "Next",

  10. "passwordLabel": "Password",

  11. "passwordValue": "Smallhelp",

  12. "loginButtonLabel": "Login"

  13. }

  14. }

这个 JSON 比前一个示例更复杂。它包含 "beforeAuthenticationLinkTexts" 属性，其中包含 "Please go to an application" 和 "Please login" 链接文本，这些文本出现在身份验证页面之前的页面中。应用程序在输入用户名的页面中有一个 "Next" 按钮。"Next" 的值被放入 JSON 中 "usernameButtonLabel" 属性的值中。

在 Windows 上的示例运行命令为：

wacat test --conf example-files\configuration-complicated-authentication.json https://mikesmallhelp-test-application-more-complicated-authentication.vercel.app/

在 Linux 和 Mac 运行：

wacat test --conf example-files/configuration-complicated-authentication.json https://mikesmallhelp-test-application-more-complicated-authentication.vercel.app/

输出为：

复制代码

  1. Testing in url: https://mikesmallhelp-test-application-more-complicated-authentication.vercel.app/. Please wait...

  4. Running 1 test using 1 worker

  5. [chromium] › test.spec.ts:40:1 › test an application

  6. Filled the username and the password. Pushed the authentication button

  7. In the page: https://mikesmallhelp-test-application-more-complicated-authentication.vercel.app/

  8. In the page: https://mikesmallhelp-test-application-more-complicated-authentication.vercel.app/working-page

  9. Push the button #1

  10. Filling the #1 text input field a value: Agc-QmUBS,Z]zx,~q*:ZNX*?L

  11. The #1 drop-down list. Selecting the option #2

  12. Push the button #1

  13. In the page: https://mikesmallhelp-test-application-more-complicated-authentication.vercel.app/working-page2

  14. Push the button #1

  15. Filling the #1 text input field a value: Agc-QmUBS,Z]zx,~q*:ZNX*?L

  16. The #1 drop-down list. Selecting the option #2

  17. Push the button #1

  18. In the page: https://mikesmallhelp-test-application-more-complicated-authentication.vercel.app/logout

  19. 1 passed (28.7s)

配置不访问的页面

wacat 设计为不超出您正在测试的主机范围。您还可以配置更多不访问的页面 URL。

查看前一个示例：

In the page: https://mikesmallhelp-test-application-more-complicated-authentication.vercel.app/logout

如果您不想进入登出页面，可以在 JSON 中添加 "notVisitLinkUrls" 属性。该属性包含不访问的 URL。示例 JSON 如下：

复制代码

  1. {

  2. "authentication": {

  3. "beforeAuthenticationLinkTexts": [

  4. "Please go to an application",

  5. "Please login"

  6. ],

  7. "usernameLabel": "Username",

  8. "usernameValue": "Mike",

  9. "usernameButtonLabel": "Next",

  10. "passwordLabel": "Password",

  11. "passwordValue": "Smallhelp",

  12. "loginButtonLabel": "Login"

  13. },

  14. "notVisitLinkUrls": [

  15. "https://mikesmallhelp-test-application-more-complicated-authentication.vercel.app/logout"

  16. ]

  17. }

在 Windows 上的示例运行命令为：

wacat test --conf example-files/configuration-complicated-authentication-with-not-visit-link-urls-remote.json https://mikesmallhelp-test-application-more-complicated-authentication.vercel.app/

在 Linux 和 Mac 上的运行命令为：

wacat test --conf example-files/configuration-complicated-authentication-with-not-visit-link-urls-remote.json https://mikesmallhelp-test-application-more-complicated-authentication.vercel.app/

命令输出为：

复制代码

  1. Testing in url: https://mikesmallhelp-test-application-more-complicated-authentication.vercel.app/. Please wait...

  3. Running 1 test using 1 worker

  4. [chromium] › test.spec.ts:40:1 › test an application

  5. Filled the username and the password. Pushed the authentication button

  6. In the page: https://mikesmallhelp-test-application-more-complicated-authentication.vercel.app/

  7. In the page: https://mikesmallhelp-test-application-more-complicated-authentication.vercel.app/working-page2

  8. Push the button #1

  9. Filling the #1 text input field a value: R?nSk,UP(UBO*t'm1^a^7HIv

  10. The #1 drop-down list. Selecting the option #2

  11. Push the button #1

  12. In the page: https://mikesmallhelp-test-application-more-complicated-authentication.vercel.app/working-page

  13. Push the button #1

  14. Filling the #1 text input field a value: R?nSk,UP(UBO*t'm1^a^7HIv

  15. The #1 drop-down list. Selecting the option #2

  16. Push the button #1

  17. 1 passed (23.2s)

请注意，输出中不再有以下行：

In the page: https://mikesmallhelp-test-application-more-complicated-authentication.vercel.app/logout
以无头模式运行

使用 --headless 标志以无头模式（无浏览器）运行。示例命令如下：

wacat test --headless https://mikesmallhelp-test-application.vercel.app/
在 CI 管道中运行

wacat 可以在 CI 管道中使用 --headless 标志运行。

配置等待时间

默认情况下，wacat 每个页面下载等待时间为 5000 毫秒。使用 --wait 标志以毫秒为单位配置页面下载等待时间。2000 毫秒等待时间的示例命令如下：

wacat test --wait 2000 https://mikesmallhelp-test-application.vercel.app/

注意：wacat 内部使用 Playwright 工具。通常情况下，Playwright 测试可以等待一些特定的文本。但 wacat 不知道要等待什么文本，因此使用等待时间。

配置整个测试的超时时间

默认情况下，整个测试命令的超时时间为 120 秒。使用 --timeout 标志以秒为单位配置整个测试的超时时间。超时时间值至少为 1 秒。50 秒超时时间的示例命令如下：

wacat test --timeout 50 https://mikesmallhelp-test-application.vercel.app/

注意：Playwright 内部使用的是毫秒。所以如果在这个示例中发生超时，输出会类似于：

Test timeout of 50000ms exceeded.
Help 指令

To see all the flags, run the command:

wacat test --help
复制代码

  1. Test any web application, for example: wacat test http://localhost:3000

  3. USAGE

  4. $ wacat test URL [--bypass-browser-console-errors] [--bypass-http-errors] [--conf <value>] [--debug] [--headless] [--input-texts <value>] [--only-links] [--random-input-texts-charset

  5. <value>] [--random-input-texts-max-length <value>] [--random-input-texts-min-length <value>] [--timeout <value>] [--wait <value>]

  7. ARGUMENTS

  8. URL Application url to test, for example: http://localhost:3000

  10. FLAGS

  11. --bypass-browser-console-errors Bypass the browser console's error messages

  12. --bypass-http-errors Bypass the HTTP errors

  13. --conf=<value> Path to the configuration file

  14. --debug Enable debug mode

  15. --headless Headless mode

  16. --input-texts=<value> Path to the input texts file

  17. --only-links Test only links

  18. --random-input-texts-charset=<value> Random input texts character set

  19. --random-input-texts-max-length=<value> Random input texts max length

  20. --random-input-texts-min-length=<value> Random input texts min length

  21. --timeout=<value> A whole test run timeout in seconds

  22. --wait=<value> A wait in milliseconds to wait a page load

  24. DESCRIPTION

  25. Test any web application, for example: wacat test http://localhost:3000

  27. EXAMPLES

  28. $ wacat test http://localhost:3000

开发 wacat

使用技术

wacat 使用以下的一些技术:

  • • Typescript

  • • Bash script

  • • oclif, The Open CLI Framework

  • • Playwright

  • • Next.js for the test applications

开发指引

在 Linux 和 Mac 上，进行更改并运行

npm run test && npm run build && npm install -g && ./run-tests.sh

run-tests.sh 脚本会运行所有测试用例，并验证 wacat 是否正常工作。或者，只需将更改推送到代码库，让 GitHub Actions 运行测试。

在 Windows 上，进行更改并运行

npm run test && npm run build && npm install -g

对于 Windows，目前还没有像 ./run-tests.sh 这样的自动测试脚本。运行

run-manual-tests.bat

并从输出中验证一切是否正常。

贡献

我们热烈欢迎各种形式的贡献。请查看问题页面。如果发现 bug 或需要某个特定功能，请创建一个新的 issue。

请注意：如果您添加了新功能，请为其添加测试用例。请查看 run-tests.sh 文件。还请考虑添加单元测试。

Change history

1.1.0 16.4.2024

  • • can derive the text input type from the label and generates an appropriate random content for the input field

    • • supports derivation from different email and date labels
1.0.0 23.3.2024

  • • Windows support

  • • support for the most typical html input types like radio, email etc.

  • • more flags like --random-input-texts-charset

  • • bug fixes

  • • GitHub Actions tests for Mac

引用链接

[1] Playwright: https://playwright.dev/
[2] 安装 Node.js 官方指引: https://nodejs.org/en

相关推荐
材料苦逼不会梦到计算机白富美32 分钟前
线性DP 区间DP C++
开发语言·c++·动态规划
java小吕布33 分钟前
Java Lambda表达式详解：函数式编程的简洁之道
java·开发语言
sukalot37 分钟前
windows C#-查询表达式基础(一)
开发语言·c#
一二小选手1 小时前
【Java Web】分页查询
java·开发语言
大G哥1 小时前
python 数据类型----可变数据类型
linux·服务器·开发语言·前端·python
Code成立1 小时前
《Java核心技术 卷I》用户图形界面鼠标事件
java·开发语言·计算机外设
Xiao Fei Xiangζั͡ޓއއ2 小时前
一觉睡醒，全世界计算机水平下降100倍，而我却精通C语言——scanf函数
c语言·开发语言·笔记·程序人生·面试·蓝桥杯·学习方法
记录无知岁月2 小时前
【MATLAB】目标检测初探
开发语言·yolo·目标检测·matlab·yolov3·yolov2
远望清一色2 小时前
基于MATLAB身份证号码识别
开发语言·图像处理·算法·matlab
NMBG222 小时前
[JAVAEE] 面试题(四) - 多线程下使用ArrayList涉及到的线程安全问题及解决
java·开发语言·面试·java-ee·intellij-idea
热门推荐
01玄机平台应急响应—webshell查杀02Ubuntu 20.04使用Livox mid 360 测试 FAST_LIO03【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总04智能车联网安全发展形势、挑战05文件或文件夹名称中有空格如何批量去除06组基轨迹建模 GBTM的介绍与实现（Stata 或 R）07【TC3xx芯片】TC3xx芯片电源管理系统PMS详解08优化手机性能，解决卡顿问题：关闭这3个微信开关，释放内存空间09基于YOLOv10深度学习的CT扫描图像肾结石智能检测系统【python源码+Pyqt5界面+数据集+训练代码】深度学习实战、目标检测10液体神经网络：LNN是个啥概念？