
Anh Tuan
Data Science Expert
Đã xuất bản Nov 18, 2026
Đã cập nhật Nov 18, 2026 · đọc tối thiểu

Cypress là một dự án kiểm thử trình duyệt được dùng để vận hành ứng dụng web và kiểm tra hành vi của chúng. FAQ chính thức của nó trình bày cách các test tương tác với ứng dụng và chờ đợi hành vi mong đợi. Điều này liên quan ở đây vì các form có CAPTCHA bảo vệ vừa có tương tác phía trình duyệt, vừa có kết quả chấp nhận phía server cần được kiểm thử.
Một solver hữu ích cho một kiểm tra tích hợp có phạm vi, khi quy trình làm việc đã được cấp quyền của bạn vốn phụ thuộc vào nhận dạng hình ảnh. Nó không phải yêu cầu cho mọi bộ test Cypress. Các test ứng dụng thường quy có thể dùng các phản hồi xác minh được kiểm soát; hãy giữ một kiểm tra trực tiếp riêng cho đường đi solver cụ thể mà bạn định hỗ trợ.
Trong ví dụ này, CapSolver nhận một ảnh qua API ImageToTextTask được tài liệu hóa của nó. Cypress nhập văn bản trả về vào form do bạn sở hữu và xác minh kết quả của form. API không bấm trang, không giữ phiên challenge, và không assert thành công cho test.
Thuật ngữ CAPTCHA giải thích khái niệm xác minh. Hướng dẫn này dùng một ảnh số đơn giản để tách biệt cơ chế tích hợp. Nó không thiết lập việc hỗ trợ cho một website bên thứ ba hay loại challenge khác.
Môi trường thực thi dùng Node.js 24.16.0, Cypress 15.21.0, và Electron 138 đi kèm Cypress. Phiên bản 15.21.0 có sẵn cục bộ và đã được xác minh trước khi chạy test; đây là phiên bản đã được kiểm thử ở đây, không phải tuyên bố về bản phát hành mới nhất.
Tạo một dự án với Cypress 15.21.0 và Sharp 0.34.5 được cài đặt. Sharp tạo một PNG cho fixture kiểm thử cục bộ. Các file dự án có thể tái lập được liệt kê bên dưới: server.cjs, cypress.config.cjs, và cypress/e2e/captcha.cy.js. Giữ server ứng dụng chạy trong một terminal và chạy Cypress từ thư mục dự án trong một terminal khác.
Lưu API key của solver trong một file văn bản cục bộ bên ngoài dự án. Đặt biến môi trường của tiến trình Node CAPSOLVER_TEST_KEY_FILE thành đường dẫn tuyệt đối của file đó. Ví dụ cũng có một đường dẫn dự phòng cục bộ cho macOS là /private/tmp/capsolver-test-key; trên Windows hoặc hệ thống khác, hãy đặt đường dẫn riêng của bạn. Giới hạn quyền truy cập tới file và loại trừ nó khỏi hệ thống quản lý mã nguồn và các artifact chia sẻ.
Key được đọc bởi Node task. Nó không bao giờ được trả lại cho test phía trình duyệt, không được đặt trong Cypress.env(), hay đưa vào mã nguồn ví dụ. Đừng dán key vào console trình duyệt hoặc vào test chạy bên trong trang.
Fixture này tạo một ảnh số, giữ đáp án mong đợi trên server và gắn nó với một challenge cookie chỉ-HTTP (HTTP-only). Trang nhận ảnh, chứ không phải đáp án dạng trường văn bản hay biến JavaScript. Gửi đáp án sai trả về Rejected; một đáp án hiện tại chính xác trả về Accepted.
Lưu đoạn dưới đây là server.cjs và khởi động nó với Node trước khi mở Cypress. Bind vào 127.0.0.1 để giữ fixture ở cục bộ. Server nhỏ này là giàn giáo kiểm thử, không phải triển khai CAPTCHA cho sản xuất.
const http=require('node:http');const crypto=require('node:crypto');const sharp=require('sharp');
const challenges=new Map();
const server=http.createServer(async(req,res)=>{
if(req.method==='GET' && req.url==='/'){
const token=crypto.randomBytes(16).toString('hex'); const answer=String(crypto.randomInt(100000,999999));
challenges.set(token,answer);
const png=await sharp(Buffer.from(`<svg xmlns="http://www.w3.org/2000/svg" width="260" height="90"><rect width="260" height="90" fill="white"/><text x="15" y="62" font-family="Arial" font-size="48" fill="black">${answer}</text></svg>`)).png().toBuffer();
res.writeHead(200,{'Content-Type':'text/html','Set-Cookie':`challenge=${token}; HttpOnly; SameSite=Strict`,'Cache-Control':'no-store'});
res.end(`<html><body><h1>Owned CAPTCHA QA fixture</h1><img id="captcha" alt="Numeric test challenge" src="data:image/png;base64,${png.toString('base64')}"><form><label>Answer<input id="answer" name="answer"></label><button>Submit</button></form><p id="result"></p><script>document.querySelector('form').onsubmit=async e=>{e.preventDefault();const r=await fetch('/verify',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({answer:document.querySelector('#answer').value})});document.querySelector('#result').textContent=await r.text();};</script></body></html>`);return;
}
if(req.method==='POST' && req.url==='/verify'){
let body=''; for await(const chunk of req)body+=chunk;
const token=(req.headers.cookie||'').match(/challenge=([a-f0-9]+)/)?.[1];
let value;try{value=JSON.parse(body).answer;}catch{res.writeHead(400);res.end('Bad request');return;}
const expected=challenges.get(token);const accepted=challenges.has(token) && expected===value;console.log(JSON.stringify({kind:'validation',expected,submitted:value,hasSession:!!token,accepted}));challenges.delete(token);
res.writeHead(accepted?200:422,{'Content-Type':'text/plain'});res.end(accepted?'Accepted':'Rejected');return;
}
res.writeHead(404);res.end('Not found');
});server.listen(18761,'127.0.0.1',()=>console.log('Owned QA fixture listening on 127.0.0.1:18761'));
Lưu ý rằng server tiêu thụ một challenge khi một đáp án được gửi. Điều đó khiến một đáp án cũ không phù hợp cho lần thử sau và giúp lộ ra việc tái sử dụng nhầm. Ứng dụng thực tế có thể dùng quy tắc vòng đời khác; hãy điều chỉnh test cho khớp với hành vi được tài liệu hóa của ứng dụng đó.
Tài liệu cy.task của Cypress định nghĩa ranh giới: test chạy trong trình duyệt, trong khi handler đã đăng ký chạy trong Node.js. Tham số và giá trị trả về băng qua ranh giới đó dưới dạng dữ liệu được tuần tự hóa.
Lưu cấu hình này là cypress.config.cjs. Payload dùng các trường clientKey, task.type, và body (ảnh) đã được CapSolver tài liệu hóa. Mã tùy chỉnh quanh yêu cầu xử lý timeout và xác minh phản hồi; đây là adapter của ứng dụng, không phải gói Cypress–CapSolver chính thức.
const { defineConfig } = require('cypress');
const fs = require('node:fs');
module.exports = defineConfig({
video: false, screenshotOnRunFailure: false, allowCypressEnv: false,
e2e: { baseUrl: 'http://127.0.0.1:18761', supportFile: false,
setupNodeEvents(on) {
on('task', {
async solveImage(body) {
const keyPath=process.env.CAPSOLVER_TEST_KEY_FILE || '/private/tmp/capsolver-test-key';
if (!fs.existsSync(keyPath)) throw new Error('Missing local solver key file; no live solve was attempted');
const clientKey=fs.readFileSync(keyPath,'utf8').trim();
if (!clientKey) throw new Error('Empty solver key file');
const response=await fetch('https://api.capsolver.com/createTask',{
method:'POST',headers:{'Content-Type':'application/json'},
body:JSON.stringify({clientKey,task:{type:'ImageToTextTask',body}}),
signal:AbortSignal.timeout(30000)
});
if(!response.ok) throw new Error(`Solver HTTP ${response.status}`);
const data=await response.json();
if(data.errorId!==0) throw new Error(`Solver task failed: ${data.errorCode || data.errorId}`);
if(typeof data.solution?.text!=='string' || !data.solution.text) throw new Error('No recognized text returned');
fs.appendFileSync('solve-evidence.jsonl',JSON.stringify({timestamp:new Date().toISOString(),taskType:'ImageToTextTask',status:data.status,solutionText:data.solution.text})+'\n');
return data.solution.text;
},
keyAvailable() { return fs.existsSync(process.env.CAPSOLVER_TEST_KEY_FILE || '/private/tmp/capsolver-test-key'); }
});
}
}
});
Phần thân ảnh là Base64 không có tiền tố data-URI. ImageToTextTask trả về trực tiếp kết quả nhận dạng, nên ví dụ này không thêm vòng lặp polling. Nếu bạn đổi sang loại CAPTCHA task khác, hãy làm theo hợp đồng phản hồi của task đó, thay vì sao chép nguyên luồng đồng bộ này.
Handler chỉ ghi lại timestamp, kiểu task, status, và văn bản đã nhận dạng từ fixture nhân tạo này. Nó không ghi API key hay request thô. Trong môi trường riêng, hãy quyết định xem văn bản đã nhận dạng có phù hợp để ghi log không và xóa bản ghi chẩn đoán đó khi không còn cần.
Nhận mã thưởng CapSolver của bạn
Tăng ngân sách tự động hóa ngay lập tức!
Dùng mã thưởng CAP26 khi nạp tiền vào tài khoản CapSolver để nhận thêm 5% bonus cho mọi lần nạp — không giới hạn.
Đổi mã ngay trong Bảng điều khiển CapSolver
Lưu đoạn sau là cypress/e2e/captcha.cy.js. Test đầu tiên xác nhận rằng một đáp án sai bị từ chối. Test thứ hai kiểm tra ranh giới Node task. Test thứ ba đọc ảnh challenge hiện tại, gọi solver thật, nhập giá trị trả về, và kiểm tra việc ứng dụng chấp nhận.
describe('Owned image CAPTCHA form', () => {
it('rejects an incorrect answer at the application boundary', () => {
cy.visit('/');
cy.get('#answer').type('incorrect');
cy.get('button').click();
cy.get('#result').should('have.text','Rejected');
});
it('runs the Node task boundary without exposing the solver key', () => {
cy.task('keyAvailable').then(value => expect(value).to.be.a('boolean'));
});
it('submits a live solver result for the current challenge', function () {
cy.task('keyAvailable').then(available => {
if(!available) this.skip();
cy.visit('/');
cy.get('#captcha').should('have.attr','src').then(src => {
const body=src.split(',')[1];
return cy.task('solveImage',body,{timeout:40000,log:false});
}).then(text => {
cy.get('#answer').type(text,{log:false,parseSpecialCharSequences:false});
cy.get('button').click();
cy.get('#result').should('have.text','Accepted');
});
});
});
});
Từ thư mục dự án này, chạy node node_modules/cypress/bin/cypress run --browser electron. Trường hợp trực tiếp sẽ cố ý chuyển sang trạng thái pending khi thiếu file key; một lần chạy màu xanh với một ca pending không phải là bằng chứng rằng tích hợp API trả phí đã hoạt động. Với một cổng tích hợp trực tiếp trong CI, hãy yêu cầu ca đó phải chạy và kiểm tra rằng không test liên quan nào bị bỏ qua.
Lệnh nhập liệu vô hiệu hóa việc phân tích ký tự đặc biệt để văn bản nhận dạng được nhập nguyên văn. Tài liệu tham chiếu Cypress type mô tả tùy chọn này. Cả test lẫn handler đều không âm thầm đổi chữ hoa/thường hoặc loại bỏ ký tự để ép cho pass.
Ví dụ được cố ý giới hạn ở chữ số. Hướng dẫn tích hợp image-CAPTCHA của CapSolver](https://www.capsolver.com/blog/n8n/how-to-solve-image-captcha-n8n) nêu rằng nhận dạng Image To Text không hỗ trợ phân biệt hoa/thường. Một challenge chữ hoa–thường hỗn hợp với yêu cầu khớp chính xác cần quyết định năng lực riêng trước khi bạn tái sử dụng workflow này.
Lần chạy cuối ngày 18 tháng 11 năm 2026 hoàn thành ba test với ba pass, không lỗi, không pending. Solver trực tiếp trả về cùng giá trị sáu chữ số mà server của fixture giữ, và ứng dụng trả về Accepted. Test đáp án sai riêng biệt xác nhận Rejected.
Một lần thử trực tiếp trước đó đã nhận được kết quả nhận dạng nhưng fail ở assert phía ứng dụng. Lần thử đó không ghi lại giá trị mong đợi và giá trị đã gửi, nên nguyên nhân chính xác không được xác định. Lần chạy sau đó đã bổ sung bằng chứng đó và xác nhận kết quả khớp. Không có biến đổi nhận dạng nào được thêm vào để ép hai giá trị trùng nhau.
Những quan sát này cho thấy request, Cypress task, nhập liệu trình duyệt, phiên, và assert phía ứng dụng có thể hoạt động cùng nhau trong ví dụ có kiểm soát này. Chúng không thiết lập tỷ lệ chính xác, cam kết mức dịch vụ, hay hành vi trên site sản xuất. Hãy giữ lần chạy lỗi trong lịch sử đánh giá của bạn; đừng chỉ báo cáo các lần thử thành công khi đo lường một solver.
Bắt đầu từ ranh giới bị lỗi. Thiếu file key sẽ chặn yêu cầu trực tiếp. Lỗi HTTP cho thấy yêu cầu không hoàn tất bình thường. Lỗi API khác 0 nghĩa là handler không được xem phản hồi như văn bản đã nhận dạng. Một chuỗi được trả về nhưng sau đó nhận Rejected đòi hỏi điều tra cấp ứng dụng.
Với trường hợp sau, hãy kiểm tra ảnh gốc, văn bản trả về, giá trị thực tế đã gửi, và xem cookie challenge còn gắn với form hiện tại không. Nếu trang làm mới challenge, hãy lấy lại ảnh. Đừng tiếp tục gửi đáp án của một challenge trước đó hay ẩn các lần gọi dịch vụ trả phí trong một vòng lặp retry không giới hạn.
Assert rằng API trả về một chuỗi là hữu ích nhưng chưa đủ. Hãy giữ assert cuối cùng trên form để selector bị hỏng, challenge hết hạn, hay đáp án sai đều tạo ra lỗi test dễ thấy.
Hãy dùng mẫu này cho một kiểm tra tích hợp solver nhỏ, rõ ràng trong một ứng dụng do bạn kiểm soát. Giữ credential trong Node, ghép loại image task với năng lực được tài liệu hóa, và xác minh kết quả của form nhận. CapSolver cung cấp bước nhận dạng; Cypress làm cho kết quả đã kiểm thử trọn vẹn trở nên hiển thị.
Hỏi: Cypress có tích hợp sẵn CAPTCHA solver không?
Ví dụ này không phụ thuộc vào solver tích hợp nào. Nó dùng cơ chế Node task mục đích chung của Cypress để gọi một API nhận dạng riêng.
H: Tôi có thể dùng đoạn mã này cho reCAPTCHA hoặc các thử thách Cloudflare không?
Không thể dùng nguyên trạng như vậy. Đoạn mã này gửi một ảnh đến ImageToTextTask và nhập văn bản đã nhận dạng. Các loại thử thách khác yêu cầu chính chúng có tập tham số vào, kết quả ra và cách tích hợp ứng dụng được ghi chép riêng.
H: Tại sao kiểm thử trực tiếp lại hiển thị đang chờ (pending) khi không có key?
Ví dụ này cố ý bỏ qua cuộc gọi trả phí khi tệp key không tồn tại. Trạng thái pending có nghĩa là tích hợp trực tiếp chưa được kiểm thử; không được tính đó là một lần giải thành công.
H: Một thử thách được chấp nhận có đủ để khẳng định độ chính xác cao không?
Không. Nó chỉ xác nhận đường đi hoạt động cho riêng ví dụ đó. Hãy đánh giá trên các đầu vào đại diện và giữ lại các lần bị từ chối trước khi đưa ra bất kỳ tuyên bố thống kê nào.
H: Đây có phải là gói tích hợp Cypress chính thức không?
Không. Đây là một adapter đã được kiểm thử, sử dụng API task chính thức của Cypress và endpoint ImageToTextTask được CapSolver ghi chép. Dạng cục bộ là khung QA nguyên gốc.

Anh Tuan
Data Science Expert
Turning task outcomes into actionable insights.
GIỚI THIỆU TÁC GIẢ
Tìm hiểu cách xử lý CAPTCHA trong tự động hóa đơn đặt hàng, lưu giữ dữ liệu đơn hàng đã được phê duyệt, xác minh xác nhận của nhà cung cấp và tránh gửi trùng lặp.

Sử dụng một danh sách kiểm CAPTCHA thực tiễn để kiểm tra trạng thái trình duyệt, các tác vụ giải mã, số lần thử lại, lỗi và kết quả cuối cùng của ứng dụng trước khi mở rộng tự động hóa.
