Scripting (डेवलपर व्यू)
प्री-सेंड / पोस्ट-रिस्पॉन्स स्क्रिप्ट Quick Request का स्विस आर्मी नाइफ है: डायनामिक साइनिंग, एन्क्रिप्शन और डिक्रिप्शन, कंडीशनल assertions और क्रॉस-रिक्वेस्ट मान पासिंग यहीं रहते हैं। स्क्रिप्ट JavaScript में लिखी जाती हैं और बिल्ट-इन QuickJS इ ंजन में चलती हैं।
यह पेज केवल UI में क्या जोड़ सकते हैं और स्क्रिप्ट क्या कर सकते हैं कवर करता है; पूरे JavaScript API सिग्नेचर के लिए Script API Reference देखें।
एक रिक्वेस्ट में दो "एक्शन चेन"
रिक्वेस्ट एडिटर पेज पर आप प्री-सेंड और पोस्ट-रिस्पॉन्स चेन में कई चरण जोड़ सकते हैं; वे क्रम में चलते हैं। हर चरण इनमें से एक है:
| चरण प्रकार | UI में क्या करते हैं | आम उपयोग |
|---|---|---|
| स्क्रिप्ट | एक टुकड़ा JavaScript लिखते हैं | हेडर/बॉडी बदलना, साइनिंग, डिक्रिप्शन, कंडीशनल लॉजिक |
| लाइब्रेरी स्क्रिप्ट | सेव किए गए साझा स्क्रिप्ट का संदर्भ | "टोकन इंजेक्ट", "एकीकृत लॉगिंग" कई जगह पुनः उपयोग |
| एक्सट्रैक्ट | रिस्पॉन्स से मान लेकर वेरिएबल सेव | लॉगिन टोकन अगली रिक्वेस्ट को पास |
| Assert | रिस्पॉन्स पर एक सत्यापन जोड़ते हैं | स्टेटस कोड = 200, फ़ील्ड मौजूद |
| प्रतीक्षा | कुछ मिलीसेकंड रुकें | रेट लिमिटिंग, पोलिंग अंतराल |
स्क्रिप्ट कैसे लिखें: दो एंट्री पॉइंट
स्क्रिप्ट इंजन आपकी स्क्रिप्ट में जाने-माने एंट्री फ़ंक्शन ढूँढता है:
// Pre-send: can change "the request that is about to go out"
async function onRequest(context, url, request) {
// e.g. inject a header
request.headers.set('X-Trace-Id', $uuid.v4());
return request; // you must return the request
}
// Post-response: can read and change "the response you received"
async function onResponse(context, url, response) {
// e.g. rewrite an encrypted response back to plaintext for humans
return response;
}
- प्री-सेंड चेन में
onRequest, पोस्ट-रिस्पॉन्स चेन मेंonResponseलिखें। - फ़ंक्शन नाम बिल्कुल यही होने चाहिए, वरना स्क्रिप्ट "no entry point" मानी जाकर छोड़ दी जाती है।
awaitसमर्थित है।
स्क्रिप्ट क्या बदल सकते हैं
रिक्वेस्ट बदलना (onRequest में request ऑब्जेक्ट)
| आप चाहते हैं | कैसे |
|---|---|
| हेडर सेट / ओवरराइड | request.headers.set('Authorization', 'Bearer ' + tok) |
| query पैराम जोड़ें / बदलें | request.queries.set('ts', String(Date.now())) |
| रॉ बॉडी पढ़ें | var text = request.body.parseText() या request.body.parseJSON() |
| पूरी बॉडी रीराइट | request.body = the new string (साधारण असाइनमेंट) |
रिस्पॉन्स पढ़ना / बदलना (onResponse में response ऑब्जेक्ट)
| आप चाहते हैं | कैसे |
|---|---|
| स्टेटस कोड पढ़ें | response.statusCode |
| रिस्पॉन्स हेडर पढ़ें | response.headers.get('Set-Cookie') |
| बॉडी पढ़ें | response.body.parseJSON() / .parseText() |
| पूरी रिस्पॉन्स बॉडी रीराइट | response.body = the new string — UI/परिणाम व्यू रीराइट किया कंटेंट दिखाता है (सत्यापित) |
बिल्ट-इन क्षमताएँ — दोबारा मत बनाएँ
स्क्रिप्ट बिल्ट-इन टूल्स (sdk.*) और $-प्रीफ़िक्स नेटिव क्षमताओं के साथ आते हैं: एन्क्रिप्शन, डाइजेस्ट, एनकोडिंग, रैंडमनेस और JSONPath सब कवर:
| क्षमता | क्या उपयोग करें |
|---|---|
| वेरिएबल पढ़ें / लिखें (क्रॉस-रिक्वेस्ट पासिंग) | sdk.env.get(name) / sdk.env.set(name, value) |
| घोषणात्मक टेस्ट | sdk.test('status should be 200', function(){ sdk.expect(response.statusCode).toBe(200) }) |
| JSONPath क्वेरी | sdk.jsonPath('$.data.id') |
| AES एन्क्रिप्शन / डिक्रिप्शन | $crypto.encryptAES(plaintext, key[, iv]) / $crypto.decryptAES(ciphertext, key[, iv]) |
| MD5 / SHA डाइजेस्ट (साइनिंग) | $hash.md5(...) / $hash.sha256(...) (hex लौटाता है, मानक और इंटरऑपरेबल) |
| UUID | $uuid.v4() |
| स्ट्रिंग base64 | sdk.utils.base64Encode(str) / base64Decode(str) |
⚠️ इंजन QuickJS है: ब्राउज़र जैसा
crypto.subtleनहीं है, औरcrypto.getRandomValuesइस इंजन में काम नहीं करता (पास किया ऐरे भरता नहीं) — AES के लिए$crypto, रैंडमनेस के लिएcrypto.randomUUID/$uuidउपयोग करें। WebCrypto तक न जाएँ। पूरे सिग्नेचर और सावधानियाँ: Script API Reference।
require() से स्क्रिप्ट लाइब्रेरी लोड करना
साझा लॉजिक को चरण के रूप में जोड़ने की बजाय CommonJS-स्टाइल require() से भी लोड किया जा सकता है। की हमेशा @libs/<key>, इस क्रम में रिज़ॉल्व होती है:
- स्क्रिप्ट-लाइब्रेरी आइडेंटिफ़ायर — सटीक मेल, रिनेम पर स्थिर (अनुशंसित)
- स्क्रिप्ट-लाइब्रेरी नाम — पढ़ने योग्य, पर लाइब्रेरी रिनेम करने पर संदर्भ टूट जाता है (अस्पष्ट डुप्लिकेट नाम छोड़ दिए जाते हैं)
- बिल्ट-इन लाइब्रेरी — ऐप के साथ बंडल