Script adımı (JavaScript)
Hazır extract ve check'ler çoğu testi karşılar. Bir değeri hesaplamanız, bir isteği imzalamanız ya da cevabı kendi kuralınızla kontrol etmeniz gerektiğinde test editöründe JavaScript yazabilirsiniz. İki yolu vardır:
- Script adımı: protokol listesinde Script (JavaScript). İstek göndermez; kod
VU'nun değişkenlerini okur, hesaplar ve yazar. Sonraki adımlar yazılan değeri
{{ad}}ile kullanır. - Öncesi / Sonrası script: her adımın Script sekmesinde. Öncesi script istekten önce koşar (HTTP'de isteği değiştirebilir), Sonrası script cevap geldikten ve extract'ler çalıştıktan sonra koşar.
Script tüm sürümlerde açıktır (Ücretsiz dahil); lisans sınırı yoktur. k6 script'lerini olduğu gibi koşturmak ayrı bir yoldur: bkz. Harici motorlar.
Script adımı eklemek
- Test editöründe Adım ekle'ye basın.
- Adım kartında Protokol listesinden Script (JavaScript) seçin. Kutuda bir örnek kod açılır.
- Kodu yazın. Satır numaraları solda görünür; Tab iki boşluk ekler.
- Kodun altındaki Dene'ye, sonra Çalıştır'a basın. Script örnek değerlerle sandbox'ta koşar ve değişen değişkenleri, check'leri ve logları gösterir. Hiçbir istek gönderilmez.
- Başarılı olduğunu şuradan anlarsınız: "Script hatasız bitti" yazar ve Değişen değişkenler satırında yazdığınız değişken görünür.
// Önceki adımın cevabından toplam tutarı hesaplayın
const sepet = response.json();
const toplam = sepet.items.reduce((t, i) => t + i.price * i.qty, 0);
vars.set('total', toplam.toFixed(2));
check('sepet boş değil', sepet.items.length > 0);Sonraki adımda {{total}} bu değeri verir.
Script adımı istek sayılmaz: istek metriklerine (RPS, gecikme) girmez. Her
iterasyonda script adında bir check yazar; script hata verirse ya da fail() derse
bu check başarısız olur. Script'in kendi check()'leri de aynı check listesinde
görünür.
Öncesi ve Sonrası script
- Bir HTTP (ya da başka protokol) adımında Script sekmesini açın.
- Öncesi script ya da Sonrası script anahtarını açın. Örnek kod gelir.
- Kodu yazıp Dene ile deneyin. Sonrası script'i denerken örnek cevabın status kodunu ve gövdesini değiştirebilirsiniz.
Öncesi script, isteği imzalamak için:
const ts = String(now());
request.headers['X-Timestamp'] = ts;
request.headers['X-Signature'] = hmac('sha256', vars.get('secret_api_key'), ts + request.body);Sonrası script, cevabı kendi kuralınızla kontrol etmek için:
const j = response.json();
check('sipariş onaylandı', j.status === 'confirmed');
if (j.total > 10000) fail('tutar beklenenden büyük: ' + j.total);
vars.set('orderId', j.id);Sıra şöyledir: Öncesi script → istek → extract'ler → Sonrası script → check'ler.
Extract'lerin yazdığı değişkenler Sonrası script'te vars.get() ile okunur.
Öncesi script hata verirse ya da fail() derse istek gönderilmez ve
adım başarısız istek (error:script) olarak sayılır. skip() ise isteği sessizce
atlar; metrik yazılmaz.
Kullanılabilen API
Kodun yanındaki turuncu i aynı listeyi kısaca gösterir.
| API | Anlamı |
|---|---|
vars.get(ad), vars.set(ad, değer), vars.has(ad), vars.del(ad) |
VU değişkenleri. Değer metne çevrilir, nesne JSON olur. |
data('users') |
Bu iterasyonun CSV satırı: {kolon: değer} ({{users.email}} ile aynı). |
request.method, request.url, request.headers, request.body |
Yalnız HTTP adımının Öncesi script'inde. Değiştirdiğiniz gönderilir. |
response.code, .status, .body, .json(), .header(ad), .duration, .failed |
Sonrası script'te adımın cevabı; script adımında bir önceki adımın cevabı (yoksa null). |
check(ad, koşul) |
Bir check sonucu. Eşikler ve raporlar okur. Adım başına en çok 50 ayrı ad. |
fail(neden) |
Adımı başarısız sayar. |
skip() |
Yalnız Öncesi script'te: bu adımın isteğini atlar. |
stop() |
İterasyonu burada bitirir. |
goto('Step adı') |
Sonraki adım olarak o adıma geçer (iterasyon başına en çok 1000 atlama). |
log(...), console.log(...) |
Koşu loguna satır yazar; Dene'de adımın altında görünür. |
uuid(), now(), randomInt(a, b), randomItem(dizi), randomString(n) |
Rastgele ve zaman yardımcıları. |
base64.encode/decode, hex.encode/decode |
Kodlama. |
md5(s), sha1(s), sha256(s), sha512(s), hmac(alg, key, mesaj, 'hex' | 'base64') |
Hash ve HMAC (varsayılan çıktı hex). |
render('{{$uuid}}-{{id}}') |
Template motoruyla aynı sonuç ({{fake.*}} dahil). |
__VU, __ITER |
VU ve iterasyon numarası. |
pm.*, expect(...) |
Postman script'lerinin alt kümesi: pm.environment.get/set, pm.response.json(), pm.test, pm.expect(x).to.eql(...). |
Kod bir fonksiyonun içinde koşar: return ile erken çıkabilirsiniz.
Sınırlar ve güvenlik
- Her çalıştırma en çok 50 ms CPU kullanır. Daha uzun gerekiyorsa JSON görünümünde
options.scriptTimeoutile en çok1sverin. Süreyi aşan script durur ve adım başarısız olur. - Sandbox'ta ağ, dosya, process ve
requireyoktur. Script runner'ın içinde koşar, hiçbir servisi bloklamaz. vars.setdeğeri en çok 1 MiB, log satırı en çok 1 KiB tutulur.log()koşu başına, runner başına dakikada 20 satır yazar; fazlası düşer ve kaç satır düştüğü yazılır.- Kaynak en çok 64 KiB olabilir.
secret_ile başlayan değişkenlervars.getile okunur amapm.environment.toObject()gibi toplu listelere girmez.
Hatalar
Script'teki hata satır ve sütunuyla gösterilir, örneğin: "Script 3. satır, 5. sütun noktasında durdu: total tanımlı değil." Ne yapmanız gerektiği de yazar.
| Mesaj | Neden | Ne yapmalı |
|---|---|---|
| Script'te yazım hatası var | Eksik parantez, tırnak, noktalı virgül | Belirtilen satırı düzeltin; editör kaydetmeden önce de uyarır. |
| … tanımlı değil | Tanımlanmamış bir ad kullanıldı | Değişkenleri vars.get('ad') ile okuyun. |
| Script süre sınırında bitmedi | Sonsuz ya da çok uzun döngü | Döngüyü kısaltın ya da options.scriptTimeout değerini artırın. |
| Script fail() ile adımı başarısız saydı | Kodunuz fail() dedi |
Mesaj sizin yazdığınızdır; koşulu kontrol edin. |
Tüm senaryoyu denemek için editörün üstündeki Dene de script'leri koşar: her adımın altında script logları ve hata satırı görünür.
Postman'dan içe aktarma
Postman koleksiyonundaki script'ler önce satır satır extract ve check'e çevrilir. Bir
script'in çevrilemeyen satırı varsa (ör. console.log, kendi hesabınız) script olduğu
gibi adımın Öncesi ya da Sonrası script'i olur ve pm alt kümesiyle koşar. İçe aktarma
raporu bunu "script olarak taşındı" diye gösterir. pm.sendRequest, setTimeout,
require gibi sandbox'ta olmayan şeyleri kullanan script'ler eskisi gibi satır satır
çevrilir; çevrilemeyen satırlar raporda listelenir.
İlgili sayfalar
- Test editörü: adım yapısı, extract, check ve Dene.
- Veri: CSV veri dosyaları ve adımlar arası değer taşıma.
- Harici motorlar: k6, JMeter, Gatling ve Locust script'lerini olduğu gibi koşturmak.