
Rajinder Singh
Deep Learning Researcher
प्रकाशित Nov 18, 2026
अद्यतन Nov 18, 2026 · मिनट पढ़ने का समय

Cypress एक ब्राउज़र‑टेस्टिंग प्रोजेक्ट है जिसका उपयोग वेब एप्लिकेशन चलाने और उनके व्यवहार की जाँच के लिए किया जाता है। इसका आधिकारिक FAQ बताता है कि टेस्ट किस तरह एप्लिकेशन के साथ इंटरेक्ट करते हैं और अपेक्षित व्यवहार का इंतज़ार करते हैं। यह यहाँ इसलिए प्रासंगिक है क्योंकि CAPTCHA‑प्रोटेक्टेड फ़ॉर्म में ब्राउज़र इंटरेक्शन और सर्वर‑साइड स्वीकृति परिणाम – दोनों की टेस्टिंग करनी होती है।
जब आपका अधिकृत वर्कफ़्लो पहले से ही इमेज रिकग्निशन पर निर्भर हो, तब एक बाउंडेड इंटीग्रेशन चेक के लिए सॉल्वर उपयोगी होता है। यह हर Cypress सूट के लिए ज़रूरी नहीं है। रुटीन एप्लिकेशन टेस्ट नियंत्रित वेरिफ़िकेशन रिस्पॉन्स का उपयोग कर सकते हैं; जिस विशेष सॉल्वर पाथ को आप सपोर्ट करना चाहते हैं, उसके लिए अलग लाइव चेक रखें।
इस उदाहरण में CapSolver अपनी प्रलेखित ImageToTextTask API के ज़रिए एक इमेज प्राप्त करता है। Cypress लौटाए गए टेक्स्ट को स्वामित्व वाली फ़ॉर्म में दर्ज करता है और फ़ॉर्म के परिणाम की जाँच करता है। API पेज पर क्लिक नहीं करती, चैलेंज सेशन को सुरक्षित नहीं रखती, और न ही टेस्ट के लिए सफलता का असर्ट करती है।
CAPTCHA ग्लॉसरी वेरिफ़िकेशन कॉन्सेप्ट समझाती है। यह ट्यूटोरियल इंटीग्रेशन मैकेनिक्स को अलग‑थलग करने के लिए एक साधारण न्यूमेरिक इमेज का उपयोग करता है। यह किसी थर्ड‑पार्टी वेबसाइट या किसी अलग चैलेंज प्रकार के लिए सपोर्ट स्थापित नहीं करता।
चलाए गए एनवायरनमेंट में Node.js 24.16.0, Cypress 15.21.0, और Cypress का बंडल्ड Electron 138 उपयोग हुआ। वर्ज़न 15.21.0 लोकली उपलब्ध था और टेस्ट चलाने से पहले वेरिफ़ाई किया गया; यही यहाँ टेस्टेड वर्ज़न है, न कि लेटेस्ट रिलीज़ के बारे में दावा।
Cypress 15.21.0 और Sharp 0.34.5 इंस्टॉल के साथ एक प्रोजेक्ट बनाएँ। Sharp लोकल टेस्ट फ़िक्स्चर के लिए PNG जेनरेट करता है। रीप्रोड्यूसिबल प्रोजेक्ट फ़ाइलें इस प्रकार हैं: server.cjs, cypress.config.cjs, और cypress/e2e/captcha.cy.js। एक टर्मिनल में एप्लिकेशन सर्वर को चलते रखें और दूसरे में प्रोजेक्ट डायरेक्टरी से Cypress चलाएँ।
अपनी सॉल्वर API कुंजी को प्रोजेक्ट के बाहर किसी लोकल टेक्स्ट फ़ाइल में स्टोर करें। Node प्रोसेस का एनवायरनमेंट वेरिएबल CAPSOLVER_TEST_KEY_FILE को उस फ़ाइल के एब्सोल्यूट पाथ पर सेट करें। उदाहरण में macOS के लिए एक लोकल फॉलबैक पाथ /private/tmp/capsolver-test-key भी है; Windows या अन्य सिस्टम पर अपना पाथ स्पष्ट रूप से सेट करें। फ़ाइल की एक्सेस सीमित रखें और उसे सोर्स कंट्रोल तथा साझा आर्टिफैक्ट से बाहर रखें।
कुंजी को Node टास्क पढ़ता है। इसे कभी भी ब्राउज़र टेस्ट को रिटर्न नहीं किया जाता, Cypress.env() में नहीं रखा जाता, और न ही उदाहरण के सोर्स में शामिल किया जाता है। किसी कुंजी को ब्राउज़र कंसोल में या पेज के अंदर चलने वाले टेस्ट में पेस्ट न करें।
यह फ़िक्स्चर एक न्यूमेरिक इमेज उत्पन्न करता है, अपेक्षित उत्तर को सर्वर पर रखता है, और उसे HTTP‑only चैलेंज कुकी से जोड़ता है। पेज को इमेज मिलती है, न कि उत्तर किसी टेक्स्ट फ़ील्ड या JavaScript वेरिएबल के रूप में। ग़लत उत्तर सबमिट करने पर Rejected मिलता है; सही चालू उत्तर पर Accepted मिलता है।
निम्न को server.cjs के रूप में सेव करें और Cypress शुरू करने से पहले Node से चलाएँ। 127.0.0.1 पर बाइंड करना फ़िक्स्चर को लोकल रखता है। यह छोटा सर्वर टेस्ट स्कैफ़ोल्डिंग है, प्रोडक्शन CAPTCHA इंप्लीमेंटेशन नहीं।
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'));
ध्यान दें कि सर्वर उत्तर सबमिट होते ही चैलेंज को कंज़्यूम कर लेता है। इससे पुराना उत्तर बाद के प्रयास के लिए अनुपयुक्त हो जाता है और आकस्मिक पुन:उपयोग प्रकट होता है। असली एप्लिकेशन अलग लाइफ़साइकल नियम अपना सकता है; टेस्ट को उस एप्लिकेशन के प्रलेखित व्यवहार के अनुसार अनुकूलित करें।
Cypress की cy.task डॉक्युमेंटेशन बाउंड्री परिभाषित करती है: टेस्ट ब्राउज़र में चलता है, जबकि रजिस्टर किया गया हैंडलर Node.js में चलता है। आर्गुमेंट और रिटर्न वैल्यू सीरियलाइज़्ड डेटा के रूप में उस बाउंड्री को पार करते हैं।
इस कॉन्फ़िगरेशन को cypress.config.cjs के रूप में सेव करें। पेलोड CapSolver की प्रलेखित clientKey, task.type, और इमेज body फ़ील्डों का उपयोग करता है। रिक्वेस्ट के आसपास की कस्टम कोड टाइमआउट और रिस्पॉन्स वेलिडेशन हैंडल करती है; यह एक एप्लिकेशन एडेप्टर है, कोई आधिकारिक 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'); }
});
}
}
});
इमेज बॉडी data‑URI प्रीफ़िक्स के बिना Base64 होती है। ImageToTextTask अपना रिकग्निशन परिणाम सीधे लौटाता है, इसलिए यह उदाहरण पोलिंग लूप नहीं जोड़ता। यदि आप किसी अन्य CAPTCHA टास्क पर स्विच करते हैं, तो इस सिंक्रोनस फ्लो को ज्यों‑का‑त्यों कॉपी करने की बजाय उस टास्क के अपने रिस्पॉन्स कॉन्ट्रैक्ट का पालन करें।
हैंडलर इस सिंथेटिक फ़िक्स्चर से केवल टाइमस्टैम्प, टास्क टाइप, स्टेटस, और पहचाना गया टेक्स्ट रिकॉर्ड करता है। यह API कुंजी या रॉ रिक्वेस्ट रिकॉर्ड नहीं करता। अपने एनवायरनमेंट में तय करें कि पहचाना गया टेक्स्ट लॉग के लिए उपयुक्त है या नहीं, और जब ज़रूरत न हो तो उस डायग्नोस्टिक रिकॉर्ड को हटा दें।
अपना CapSolver बोनस कोड रीडीम करें
अपनी ऑटोमेशन बजट को तुरंत बूस्ट करें!
CapSolver अकाउंट में टॉप‑अप करते समय बोनस कोड CAP26 का उपयोग करें और हर रिचार्ज पर अतिरिक्त 5% बोनस पाएँ — बिना किसी लिमिट के।
इसे अभी अपने CapSolver Dashboard में रीडीम करें।
निम्न को cypress/e2e/captcha.cy.js के रूप में सेव करें। पहला टेस्ट कन्फर्म करता है कि ग़लत उत्तर को रिजेक्ट किया जाता है। दूसरा Node टास्क बाउंड्री को एक्सरसाइज़ करता है। तीसरा मौजूदा चैलेंज इमेज पढ़ता है, वास्तविक सॉल्वर को कॉल करता है, लौटाई गई वैल्यू दर्ज करता है, और एप्लिकेशन की स्वीकृति को चेक करता है।
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');
});
});
});
});
इस प्रोजेक्ट डायरेक्टरी से node node_modules/cypress/bin/cypress run --browser electron चलाएँ। लाइव केस जानबूझकर तब पेंडिंग हो जाता है जब कुंजी फ़ाइल अनुपस्थित हो; पेंडिंग केस के साथ हरा रन इस बात का प्रमाण नहीं है कि पेड API इंटीग्रेशन काम कर गया। CI में लाइव इंटीग्रेशन गेट के लिए, उस केस का चलना ज़रूरी रखें और यह सुनिश्चित करें कि कोई प्रासंगिक टेस्ट स्किप न हुआ हो।
इनपुट कमांड स्पेशल‑कैरेक्टर पार्सिंग को डिसेबल करता है ताकि पहचाना गया टेक्स्ट ज्यों‑का‑त्यों दर्ज हो। Cypress type रेफ़रेंस इस विकल्प का डॉक्युमेंटेशन देता है। न टेस्ट और न ही हैंडलर लेटर केस बदलते हैं या कैरेक्टर हटाते हैं ताकि जबरन पास मिल सके।
उदाहरण जानबूझकर न्यूमेरिक है। CapSolver की इमेज‑CAPTCHA इंटीग्रेशन गाइड बताती है कि Image To Text रिकग्निशन केस सेंसिटिविटी सपोर्ट नहीं करता। जहाँ मिक्स्ड‑केस चैलेंज के लिए सटीक केस मैचिंग ज़रूरी हो, वहाँ इस वर्कफ़्लो को दोबारा उपयोग करने से पहले अलग क्षमता निर्णय की ज़रूरत होगी।
18 नवंबर 2026 की अंतिम रन में तीन टेस्ट पूरे हुए, तीनों पास, कोई फेल्यर नहीं, और कोई पेंडिंग टेस्ट नहीं। लाइव सॉल्वर ने वही छह‑अंकीय वैल्यू लौटाई जो फ़िक्स्चर के सर्वर पर थी, और एप्लिकेशन ने Accepted लौटाया। ग़लत‑उत्तर वाले टेस्ट ने अलग से Rejected कन्फर्म किया।
एक पहले लाइव प्रयास में रिकग्निशन परिणाम मिला लेकिन एप्लिकेशन असर्शन फेल हो गया। उस प्रयास ने अपेक्षित और सबमिटेड वैल्यू रिकॉर्ड नहीं की थीं, इसलिए सटीक कारण स्थापित नहीं हुआ। बाद के रन में वह सबूत जोड़ा गया और मिलती हुई वैल्यू कन्फर्म हुई। वैल्यू को मिलाने के लिए कोई रिकग्निशन ट्रांसफॉर्मेशन नहीं जोड़ा गया।
ये ऑब्ज़र्वेशन दिखाते हैं कि रिक्वेस्ट, Cypress टास्क, ब्राउज़र इनपुट, सेशन, और एप्लिकेशन असर्शन – सब इस कंट्रोल्ड उदाहरण में एक साथ काम कर सकते हैं। ये किसी एक्यूरेसी रेट, सर्विस‑लेवल गारंटी, या प्रोडक्शन साइट पर व्यवहार को स्थापित नहीं करते। फेल्ड रन को भी अपनी इवैल्यूएशन हिस्ट्री में रखें; सॉल्वर को मापते समय सिर्फ सफल प्रयासों की रिपोर्ट न करें।
फेल हुई बाउंड्री से शुरू करें। गायब कुंजी फ़ाइल लाइव रिक्वेस्ट रोक देती है। HTTP एरर संकेत देता है कि रिक्वेस्ट सामान्य रूप से पूरी नहीं हुई। नॉनज़ीरो API एरर का मतलब है कि हैंडलर रिस्पॉन्स को पहचाने हुए टेक्स्ट की तरह ट्रीट नहीं कर सकता। लौटाई गई स्ट्रिंग के बाद Rejected दिखाई देने पर एप्लिकेशन‑लेवल जाँच की ज़रूरत है।
उस अंतिम केस में, मूल इमेज, लौटाया गया टेक्स्ट, वास्तव में सबमिट की गई वैल्यू, और क्या चैलेंज कुकी अब भी मौजूदा फ़ॉर्म से जुड़ी है, यह सब देखें। अगर पेज अपना चैलेंज रिफ़्रेश करता है, तो इमेज को दोबारा प्राप्त करें। पुराने चैलेंज के उत्तर को बार‑बार सबमिट न करें और न ही बिना सीमा वाले रीट्राइ लूप के अंदर दोहराए गए पेड कॉल छुपाएँ।
API ने स्ट्रिंग लौटाई, इस पर असर्शन उपयोगी है लेकिन अधूरा है। अंतिम फ़ॉर्म असर्शन को बनाए रखें ताकि टूटी हुई सेलेक्टर, एक्सपायर चैलेंज, या ग़लत उत्तर से स्पष्ट टेस्ट फेल्यर मिल सके।
इस पैटर्न का उपयोग उस एप्लिकेशन में एक छोटा, स्पष्ट सॉल्वर इंटीग्रेशन चेक करने के लिए करें जिसे आप नियंत्रित करते हैं। क्रेडेंशियल Node में रखें, इमेज टास्क को उसकी प्रलेखित क्षमता से मैच करें, और रिसीविंग फ़ॉर्म के परिणाम को वेरिफ़ाई करें। CapSolver रिकग्निशन स्टेप प्रदान करता है; Cypress पूरे टेस्टेड परिणाम को विज़िबल बनाता है।
प्रश्न: क्या Cypress में बिल्ट‑इन CAPTCHA सॉल्वर शामिल है?
यह उदाहरण किसी बिल्ट‑इन सॉल्वर पर निर्भर नहीं है। यह एक अलग रिकग्निशन API को कॉल करने के लिए Cypress की जनरल‑परपज़ Node टास्क मेकैनिज़्म का उपयोग करता है।
प्र: क्या मैं इस कोड का उपयोग reCAPTCHA या Cloudflare चुनौतियों के लिए कर सकता हूँ?
जैसा लिखा है, वैसा नहीं। यह कोड केवल एक इमेज को ImageToTextTask पर भेजता है और पहचाना गया टेक्स्ट दर्ज करता है। अन्य प्रकार की चुनौतियों के लिए उनके लिए प्रलेखित इनपुट, आउटपुट और एप्लिकेशन इंटीग्रेशन की ज़रूरत होती है।
प्र: बिना key के लाइव टेस्ट “pending” क्यों दिखता है?
उदाहरण में स्पष्ट रूप से यह शर्त रखी गई है कि key फ़ाइल न होने पर paid कॉल को छोड़ दिया जाए। Pending का मतलब है कि लाइव इंटीग्रेशन का परीक्षण नहीं हुआ; इसे सफल solve के रूप में गिना नहीं जाना चाहिए।
प्र: क्या केवल एक स्वीकृत चुनौती से उच्च सटीकता (high accuracy) का दावा किया जा सकता है?
नहीं। इससे सिर्फ यह सिद्ध होता है कि उस उदाहरण के लिए कार्यशील मार्ग (functional path) मौजूद है। कोई भी सांख्यिकीय दावा करने से पहले प्रतिनिधि इनपुट्स का परीक्षण करें और अस्वीकार की गई कोशिशों को भी सुरक्षित रखें।
प्र: क्या यह एक आधिकारिक Cypress इंटीग्रेशन पैकेज है?
नहीं। यह आधिकारिक Cypress task API और प्रलेखित CapSolver ImageToTextTask endpoint का उपयोग करने वाला एक परीक्षण किया हुआ एडेप्टर है। लोकल फ़ॉर्म मूल QA स्कैफ़ोल्डिंग है।

Rajinder Singh
Deep Learning Researcher
Making CAPTCHA solving more reliable in automated workflows.
लेखक के बारे में
खरीद आदेश स्वचालन में CAPTCHA को संभालना, स्वीकृत आदेश डेटा को सुरक्षित रखना, आपूर्तिकर्ता की पुष्टियों को सत्यापित करना, और डुप्लिकेट सबमिशन से बचना सीखें।

स्केलिंग ऑटोमेशन से पहले ब्राउज़र की स्थिति, सॉल्वर कार्य, पुनः प्रयास, त्रुटियों और अंतिम एप्लिकेशन परिणामों को सत्यापित करने के लिए एक व्यावहारिक CAPTCHA प्रोडक्शन चेकलिस्ट का उपयोग करें।
