引言
\[!提示\] 💡 选择您的语言： - 英国（国旗） 英语 - 波兰（Poland） 波兰语
这个应用程序（称为 🦎 GAD（可能代表某种特定含义或缩写，具体需根据上下文确定，此处直译为“🦎 GAD”）（某物）被制备并开发出来 仅用于测试目的它提供：
- 图形用户界面（GUI）
- REST API（Representational State Transfer Application Programming Interface，表述性状态传递应用程序编程接口）
- 集成Swagger文档
该应用程序包含简单逻辑、统计、图表、游戏以及各种资源等功能。其设计旨在（此处根据上下文，可补充具体设计目的，如“提供用户友好的体验”或“满足多样化需求”等，但原文未给出具体目的，故保留原样） 故意设置漏洞（或故意引入错误）🐛 以及模拟现实世界项目复杂性的挑战。
🦎 GAD（注：GAD在此处可能是一个特定上下文中的缩写或代号，没有具体含义，直接保留原样） 非常适合学习测试自动化、完善质量保证技术，并在遇到的各种场景中进行实践， 实际项目 伴随着各种现实世界场景。
P.S. 此外，该应用程序还有一些 严重的设计缺陷 - 我想知道你是否会注意到它们？😉
\[!重要\]\ 想快速测试一下这个应用吗？ - 克隆或下载仓库 - 跑步npm i- 跑npm run start- 开放 http://localhost:3000 翻译为中文是：“本地主机上的3000端口”。不过，在中文语境中，我们通常不会直接这样表述网址，而是可能说“访问本地服务器的3000端口”或者“打开本地3000端口的网页”。但直接翻译网址本身，就是“http://localhost:3000” 在您的浏览器中 - 享受测试和自动化工作 🦎 GAD（可能指某种特定概念或缩写，具体含义需根据上下文确定，此处直译为“蜥蜴 GAD”）！
目录
- 在本地部署 - 首次使用 - 更新版本 - 如果你正在使用zip包 - 如果你正在使用克隆的仓库 - 如果您有任何更改（例如数据库中的更改），请更新版本 - CLI 选项 - 运行CLI选项 - 部署到Glitch - 部署到Render - - 先决条件： - 跑步
特点/特性
特点为 🦎 GAD（此处“GAD”可能代表某种特定含义或缩写，但无具体上下文难以准确翻译，故保留原样）：
- GUI（Graphical User Interface）翻译为中文是“图形用户界面” （前端）
- REST API（Representational State Transfer Application Programming Interface，表述性状态传递应用程序编程接口） 并且 WebSockets（网络套接字） （后端）
- 两个应用领域:
- 测试人员博客 - 资源 - 文章、用户、评论等 - 功能 - 点赞、评论、标签以及用户互动工具 - 见解 - 统计数据和图表（例如，每用户的点赞数、每篇文章的评论数） - 认证 并且 授权 - 练习页 - 一个汇集了自动化挑战的页面集合，例如： - Iframes（框架嵌入） - 文件上传 - 拖放 - 动态元素 - 点赞、标签和调查 - 横幅广告、弹窗、前端和后端逻辑 - 游戏多多，乐趣无限！
- Swagger 文档 API文档，实现无缝集成
- 简单数据库 基于JSON的数据库，带有用于清除/恢复数据的REST API端点
- 各种数据集 - 小型、中型和大型数据集，用于模拟真实世界场景
- 动态配置 - 调整应用程序设置 很容易地从用户界面（UI）上
- 功能标志 - 启用或禁用功能 - 错误标志 - 为测试目的引入或移除错误
- 不同的 数据展示 （图表、表格等）
- 测试自动化中的挑战性要素 （嵌入框架、文件上传、拖放功能、双因素认证、标签、调查问卷、横幅广告、弹窗、前端和后端逻辑、动态元素、游戏等）
- 管理员后台包括高级功能，如：
- 数据库重置 - 用于实验和测试查询的SQL练习场
部署
如何将所展示的服务部署到各种免费托管网站的说明。
部署于 本地
要求：
- Node.js 安装在系统中
- 在Node.js上测试 v20 和 v22
- git 安装在系统中
首次使用
步骤：
- 在 cmd/终端中打开项目根目录
- 使用以下命令克隆仓库：
git clone ...
- 这是 首选方式 使用这个应用程序
- 跑
npm i
- 安装模块（不要使用 Node.js 全局包！）
- 跑
npm run start
- 启动GAD
该应用程序将在 http://localhost:3000
更新版本
如果你正在使用zip包
步骤：
- 下载压缩包形式的仓库
- 解压并替换您本地的GAD实例
- 跑
npm i在根目录下
- 安装新模块
- 跑
npm run start
- 启动GAD
如果你正在使用克隆的仓库
步骤：
- 在 cmd/终端中打开项目根目录
- 使用（命令/工具）拉取最新更改
git pull - 跑
npm i
- 安装新模块
- 跑
npm run start
- 启动GAD
如果您有任何更改（例如数据库中的更改），请更新版本
一种可能的方法是重置所有本地更改并拉取新版本。使用此方法： 您将丢失所有本地更改和数据！
步骤：
- 在 cmd/终端中打开项目根目录
- 使用以下命令重置本地更改并拉取最新更改：
git reset --hard HEAD
git pull- 跑步
npm i
- 安装新模块
- 跑
npm run start
- 启动GAD
CLI 选项
\[!提示\] CLI（命令行界面）是一种允许您在终端中使用命令与应用程序进行交互的界面。
| 选项 | 描述 |
|---|---|
| READ_ONLY=1 | 以只读模式运行。此设置禁用除登录外的所有POST、PUT和PATCH方法。 |
| PORT=3001 | 在选定端口上运行。GAD 在默认端口上运行 3000（此行无实际内容，若需翻译前文，则根据上下文灵活处理，此处仅展示格式） |
| DB="db_name" | 使用选定的数据库文件。GAD 使用 db.json 作为默认数据库。示例（针对 PowerShell）： $env:DB="db-base-big"; npm run start |
\[!警告\] ⚠️ 警告：终端中设置的所有环境变量都将被应用程序使用。如果您希望不带任何选项运行应用程序，请确保清除所有环境变量。
运行CLI选项
运行GAD需使用 CLI 选项，使用以下命令，例如：
PowerShell：
$env:PORT=3001; npm run startBash（注：Bash是Unix和Linux系统中的一个命令行解释器，全称为Bourne-Again SHell）
PORT=3001 npm run startWindows 命令行（Cmd）:
set PORT=3001 && npm run start部署到 渲染
Render——一个广受欢迎的类似Heroku的PaaS平台，提供免费套餐，并配有“部署到Render”按钮，支持一键部署。
- 在 https://dashboard.render.com/register 创建免费账户
- 成功注册后，点击按钮：
- 给你的应用命名
- 命中；击中
Apply - 稍等一会儿，然后点击项目链接
GUI API Demo - 点击链接打开应用（位于项目名称和仓库下方）
- 每月享受750小时的免费服务
在Render上部署GAD应用程序时，请注意，由于Render平台的限制，应用程序可能无法完全正常运行。不过，我们正在尽最大努力确保尽可能高的兼容性。
使用Docker镜像进行部署
这个方法可以用来：
- 本地地
- 在CI/CD服务中（如GitHub Actions、GitLab CI等）
先决条件：
在本地环境中：
- 已安装最新版本的Docker
跑步
只需运行以下命令即可获取最新镜像：
docker run -p 3000:3000 -d jaktestowac/gad或特定版本：
docker run -p 3000:3000 -d jaktestowac/gad:2.5.5应用程序应在 http://localhost:3000/ 下运行
图片可在此处查看：
部署到 故障/错乱
\[!警告\] > ⚠️ 警告：此部署方法已过时，不再推荐使用。 Glitch 已更改他们的 平台政策 这种部署方法可能无法再按预期工作。请改用其他部署方法之一。
无需注册账号 - 但您的项目将在5天后删除。~~
点击下方按钮后，请等待一两分钟以完成部署。（此处为模拟对话，实际无对应中文翻译内容，原句为无意义符号组合）
~~呜呜
查看网站：
~~- 滚动到底部按钮~~ ~~- 点击 🔎PREVIEW~~ \- 选择 👯Preview in a new window~~
在Glitch上部署GAD应用程序时，请注意，由于Glitch平台的限制，应用程序可能无法完全正常运行。不过，我们正在尽全力确保尽可能高的兼容性。好的
自动化愉快！
我们希望你在测试和自动化这个应用程序的过程中能度过一段愉快的时光！
所包含的挑战和特点旨在帮助你在享受乐趣的同时提升测试技能。
如果您有任何改进建议或遇到任何问题，请随时在我们的（平台/系统）上提交问题 。
您的反馈有助于让GAD对每个人来说都变得更好！
📢 期待您的贡献，祝测试愉快！🦎 爬行动物（如蜥蜴）的符号
📞 联系与支持
请随时联系我们：
- 🌐 表示“互联网”或“世界万维网”。 网站: jaktestowac.pl（可译为“如何测试网站/如何进行测试”等，具体翻译取决于上下文，该域名本身可理解为“如何测试（的网站/方法等）”）
- 💼（公文包、办公用品等的象征） 领英： jaktestowac.pl（可译为“如何测试网”，但具体翻译可能需根据网站实际内容调整）
- 💬 Discord（一款即时通讯及视频会议软件）: 波兰剧作家社群
- 📧 电子邮件 支持请访问我们的网站查看联系方式
- 🐛 这个表情符号通常表示“虫子”或“错误”（在编程语境中），但直接翻译可能无法完全传达其在网络交流中的特定含义，因此可以意译为“小错误”或“出bug了”。 问题：
______________________________________________________________________
学习资源
我们已收集了一系列资源，帮助您学习并掌握Playwright，提供波兰语和英语版本。无论您是初学者还是高级用户，这些资源都将有助于您提升技能和知识。
🇵🇱 波兰资源
- 面向测试人员的TypeScript - 快速入门指南 - 为测试人员提供的免费（4小时+）TypeScript课程
- 测试人员的JavaScript与TypeScript指南 - 为测试人员提供的全面（13小时+）JavaScript和TypeScript课程，包含实用示例和练习
- 使用Playwright实现专业测试自动化 - 关于Playwright、测试自动化、CI/CD和测试架构的全面（100小时+）课程
- 后端测试自动化 - 全面（45小时+）的后端测试自动化课程，使用Postman、Mocha、Chai和Supertest
- 免费剧作家资源 - 全面且免费的波兰语学习资料
- Playwright 基础知识 - YouTube系列（波兰语）
- Playwright 元素（或：Playwright 的组件/部分） - 高级概念（波兰语）
- Playwright MCP - MCP课程（波兰语）
- Discord 社区 - 首个波兰剧作家社群！
- 剧作家信息 - 首个且唯一的波兰剧作家博客
🇬🇧 英文资源
- VS Code 扩展 - 我们的免费Playwright插件
_附言：如需更多资源和最新动态，请关注我们的 网站 并且 。_
______________________________________________________________________
由……提供动力/支持 jaktestowac.pl 翻译为中文可以是“如何测试网站/如何进行测试（.pl域名下的示例）”。不过，由于“.pl”是波兰的国家顶级域名，且“jaktestowac”在波兰语中意为“如何测试”，所以这个网址可能是一个专门讨论或提供测试方法的波兰语网站。在中文语境下，我们通常不会直接翻译网址，而是根据网址内容来解释其可能的功能或主题。因此，这个网址可以理解为“一个关于测试方法的波兰语网站（.pl）”。 团队！ 💚❤️ 翻译为中文可以是“绿心❤️”（注：这里的“绿心”是根据表情符号的直观颜色和常见含义进行的翻译，实际翻译可能因语境而异，但通常会保留其象征意义，如爱心的绿色变体）。不过，直接描述这两个表情符号组合的话，可以简单地说成“绿心和红心”。