
Ethan Collins
AI Agent Workflow Engineer
Diterbitkan Nov 18, 2026
Diperbarui Nov 18, 2026 · min baca

Cypress adalah proyek pengujian browser yang digunakan untuk menjalankan aplikasi web dan memeriksa perilakunya. FAQ resminya membahas bagaimana tes berinteraksi dengan aplikasi dan menunggu perilaku yang diharapkan. Ini relevan di sini karena form yang dilindungi CAPTCHA memiliki interaksi browser dan hasil penerimaan sisi server yang perlu diuji.
Solver berguna untuk pemeriksaan integrasi terbatas ketika alur kerja terotorisasi Anda memang sudah bergantung pada pengenalan gambar. Solver bukan persyaratan untuk setiap suite Cypress. Tes aplikasi rutin dapat menggunakan respons verifikasi terkontrol; simpan cek live terpisah untuk jalur solver spesifik yang memang ingin Anda dukung.
Dalam contoh ini, CapSolver menerima gambar melalui API ImageToTextTask yang telah didokumentasikan. Cypress memasukkan teks yang dikembalikan ke dalam form milik sendiri dan memverifikasi hasil form. API tidak mengklik halaman, tidak mempertahankan sesi challenge, dan tidak melakukan asersi keberhasilan untuk tes.
Glosarium CAPTCHA menjelaskan konsep verifikasi. Tutorial ini menggunakan gambar numerik sederhana untuk mengisolasi mekanisme integrasi. Tutorial ini tidak menetapkan dukungan untuk situs pihak ketiga atau jenis challenge yang berbeda.
Lingkungan eksekusi menggunakan Node.js 24.16.0, Cypress 15.21.0, dan Electron 138 bundelan Cypress. Versi 15.21.0 tersedia secara lokal dan sudah diverifikasi sebelum menjalankan tes; itu versi yang diuji di sini, bukan klaim tentang rilis terbaru.
Buat proyek dengan Cypress 15.21.0 dan Sharp 0.34.5 terpasang. Sharp menghasilkan PNG untuk fixture uji lokal. Berkas proyek yang dapat direproduksi tercantum di bawah: server.cjs, cypress.config.cjs, dan cypress/e2e/captcha.cy.js. Jalankan server aplikasi di satu terminal dan jalankan Cypress dari direktori proyek di terminal lain.
Simpan kunci API solver Anda dalam file teks lokal di luar proyek. Setel variabel lingkungan proses Node CAPSOLVER_TEST_KEY_FILE ke path absolut file tersebut. Contoh ini juga memiliki path fallback lokal macOS, /private/tmp/capsolver-test-key; pada Windows atau sistem lain, setel path Anda sendiri secara eksplisit. Batasi akses ke file dan kecualikan dari kontrol versi dan artefak bersama.
Kunci dibaca oleh tugas Node. Kunci tidak pernah dikembalikan ke tes browser, tidak ditempatkan di Cypress.env(), dan tidak disertakan dalam contoh sumber. Jangan menempelkan kunci ke konsol browser atau ke dalam tes yang berjalan di dalam halaman.
Fixture ini menghasilkan gambar numerik, menyimpan jawaban yang diharapkan di server, dan mengaitkannya dengan cookie challenge HTTP-only. Halaman menerima gambar, bukan jawaban dalam bentuk field teks atau variabel JavaScript. Mengirim jawaban yang salah mengembalikan Rejected; jawaban saat ini yang tepat mengembalikan Accepted.
Simpan yang berikut sebagai server.cjs dan jalankan dengan Node sebelum meluncurkan Cypress. Binding ke 127.0.0.1 menjaga fixture tetap lokal. Server kecil ini adalah scaffolding tes, bukan implementasi CAPTCHA produksi.
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'));
Perhatikan bahwa server mengonsumsi sebuah challenge ketika jawaban dikirimkan. Hal ini membuat jawaban lama tidak layak untuk percobaan berikutnya dan membantu mengungkap penggunaan ulang yang tidak disengaja. Aplikasi nyata mungkin menggunakan aturan siklus hidup berbeda; sesuaikan tes dengan perilaku terdokumentasi aplikasi tersebut.
Dokumentasi cy.task Cypress mendefinisikan batasannya: tes berjalan di browser, sedangkan handler yang terdaftar berjalan di Node.js. Argumen dan nilai kembali melintasi batas tersebut sebagai data terserialisasi.
Simpan konfigurasi berikut sebagai cypress.config.cjs. Payload menggunakan field clientKey, task.type, dan body gambar yang telah didokumentasikan oleh CapSolver. Kode kustom di sekitar permintaan menangani timeout dan validasi respons; ini adalah adapter aplikasi, bukan paket resmi Cypress–CapSolver.
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'); }
});
}
}
});
Body gambar berupa Base64 tanpa awalan data-URI. ImageToTextTask mengembalikan hasil pengenalannya secara langsung, sehingga contoh ini tidak menambahkan loop polling. Jika Anda beralih ke tugas CAPTCHA lain, ikuti kontrak respons tugas tersebut alih-alih menyalin alur sinkron ini apa adanya.
Handler hanya mencatat timestamp, jenis tugas, status, dan teks yang dikenali dari fixture sintetis ini. Handler tidak mencatat kunci API atau request mentah. Di lingkungan Anda sendiri, putuskan apakah teks yang dikenali layak dicatat dan hapus rekaman diagnostik tersebut ketika sudah tidak diperlukan.
Tukarkan Kode Bonus CapSolver Anda
Tingkatkan anggaran otomatisasi Anda seketika!
Gunakan kode bonus CAP26 saat mengisi saldo akun CapSolver Anda untuk mendapatkan bonus 5% tambahan di setiap top up — tanpa batas.
Tukarkan sekarang di Dashboard CapSolver
Simpan yang berikut sebagai cypress/e2e/captcha.cy.js. Tes pertama memastikan bahwa jawaban salah ditolak. Tes kedua menguji batas tugas Node. Tes ketiga membaca gambar challenge saat ini, memanggil solver nyata, memasukkan nilai yang dikembalikan, dan memeriksa penerimaan aplikasi.
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');
});
});
});
});
Dari direktori proyek ini, jalankan node node_modules/cypress/bin/cypress run --browser electron. Kasus live sengaja menjadi pending ketika file kunci tidak ada; run hijau dengan kasus pending bukan bukti bahwa integrasi API berbayar bekerja. Untuk gerbang integrasi live di CI, wajibkan kasus tersebut dijalankan dan periksa bahwa tidak ada tes relevan yang dilewati.
Perintah input menonaktifkan parsing karakter khusus sehingga teks yang dikenali dimasukkan secara literal. Referensi perintah type Cypress mendokumentasikan opsi ini. Baik tes maupun handler tidak diam-diam mengubah huruf besar–kecil atau menghapus karakter untuk memaksa keberhasilan.
Contoh ini sengaja numerik. Panduan integrasi image-CAPTCHA CapSolver](https://www.capsolver.com/blog/n8n/how-to-solve-image-captcha-n8n) menyatakan bahwa pengenalan Image To Text tidak mendukung sensitivitas huruf besar–kecil. Challenge huruf campuran dengan pencocokan huruf persis membutuhkan keputusan kapabilitas terpisah sebelum Anda menggunakan ulang alur kerja ini.
Run terakhir pada 18 November 2026 menyelesaikan tiga tes dengan tiga lolos, tanpa kegagalan, dan tanpa tes pending. Solver live mengembalikan nilai enam digit yang sama dengan yang disimpan server fixture, dan aplikasi mengembalikan Accepted. Tes jawaban salah secara terpisah memastikan Rejected.
Percobaan live sebelumnya menerima hasil pengenalan tetapi gagal pada asersi aplikasi. Percobaan itu tidak mencatat nilai yang diharapkan dan yang dikirim, sehingga penyebab pastinya tidak diketahui. Run berikutnya menambahkan bukti tersebut dan mengonfirmasi hasil yang cocok. Tidak ada transformasi pengenalan yang ditambahkan untuk menyamakan nilai-nilai tersebut.
Pengamatan ini menetapkan bahwa permintaan, tugas Cypress, input browser, sesi, dan asersi aplikasi dapat bekerja bersama dalam contoh terkontrol ini. Pengamatan ini tidak menetapkan tingkat akurasi, jaminan tingkat layanan, atau perilaku di situs produksi. Simpan run gagal dalam riwayat evaluasi Anda; jangan hanya melaporkan percobaan berhasil saat mengukur solver.
Mulailah dari batas yang gagal. File kunci yang hilang mencegah permintaan live. Error HTTP menunjukkan bahwa permintaan tidak selesai dengan normal. Error API nonnol berarti handler tidak boleh memperlakukan respons sebagai teks yang dikenali. String yang dikembalikan tetapi diikuti Rejected memerlukan investigasi di tingkat aplikasi.
Untuk kasus terakhir, periksa gambar asli, teks yang dikembalikan, nilai yang benar-benar dikirim, dan apakah cookie challenge masih dikaitkan dengan form saat ini. Jika halaman menyegarkan challenge-nya, dapatkan kembali gambar. Jangan terus mengirim jawaban dari challenge sebelumnya atau menyembunyikan pemanggilan berbayar berulang di dalam loop retry tanpa batas.
Asersi bahwa API mengembalikan sebuah string berguna tetapi tidak lengkap. Pertahankan asersi form akhir sehingga selector yang rusak, challenge kedaluwarsa, atau jawaban salah menghasilkan kegagalan tes yang terlihat.
Gunakan pola ini untuk pemeriksaan integrasi solver yang kecil dan eksplisit dalam aplikasi yang Anda kendalikan. Simpan kredensial di Node, cocokkan tugas gambar dengan kapabilitas terdokumentasinya, dan verifikasi hasil form penerima. CapSolver menyediakan langkah pengenalan; Cypress membuat hasil akhir yang diuji menjadi terlihat.
T: Apakah Cypress memiliki solver CAPTCHA bawaan?
Contoh ini tidak bergantung pada solver bawaan. Contoh ini menggunakan mekanisme tugas Node serbaguna milik Cypress untuk memanggil API pengenalan terpisah.
T: Bisakah saya menggunakan kode ini untuk tantangan reCAPTCHA atau Cloudflare?
Tidak dalam bentuknya sekarang. Kode ini mengirimkan sebuah gambar ke ImageToTextTask dan memasukkan teks yang dikenali. Jenis tantangan lain memerlukan input, output, dan integrasi aplikasi mereka sendiri yang telah didokumentasikan.
T: Mengapa pengujian langsung ditampilkan sebagai pending tanpa key?
Contoh ini secara eksplisit melewati pemanggilan berbayar ketika berkas key tidak ada. Pending berarti integrasi langsung tidak diuji; status ini tidak boleh dihitung sebagai penyelesaian yang berhasil.
T: Apakah satu tantangan yang diterima sudah cukup untuk mengklaim akurasi tinggi?
Tidak. Itu hanya mengonfirmasi jalur fungsional untuk contoh tersebut. Evaluasilah input yang representatif dan simpan percobaan yang ditolak sebelum membuat klaim statistik apa pun.
T: Apakah ini paket integrasi Cypress resmi?
Tidak. Ini adalah adapter yang telah diuji dengan menggunakan task API resmi Cypress dan endpoint CapSolver ImageToTextTask yang telah didokumentasikan. Bentuk lokalnya adalah scaffolding QA orisinal.

Ethan Collins
AI Agent Workflow Engineer
Building clearer handoffs between AI agents and tools.
TENTANG PENULIS
Pelajari cara menangani CAPTCHA dalam otomatisasi pesanan pembelian, menjaga data pesanan yang disetujui, memverifikasi konfirmasi pemasok, dan menghindari pengiriman ganda.

Gunakan daftar periksa praktis untuk pembuatan CAPTCHA guna memverifikasi status browser, tugas pemecah, percobaan ulang, kesalahan, dan hasil akhir aplikasi sebelum melakukan otomasi skala besar.
