SpitfireYük Testi ve APMYenilikler

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

  1. Test editöründe Adım ekle'ye basın.
  2. Adım kartında Protokol listesinden Script (JavaScript) seçin. Kutuda bir örnek kod açılır.
  3. Kodu yazın. Satır numaraları solda görünür; Tab iki boşluk ekler.
  4. 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.
  5. 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.
js
// Ö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.

Not

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

  1. Bir HTTP (ya da başka protokol) adımında Script sekmesini açın.
  2. Öncesi script ya da Sonrası script anahtarını açın. Örnek kod gelir.
  3. 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:

js
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:

js
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.

Dikkat

Ö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.scriptTimeout ile en çok 1s verin. Süreyi aşan script durur ve adım başarısız olur.
  • Sandbox'ta ağ, dosya, process ve require yoktur. Script runner'ın içinde koşar, hiçbir servisi bloklamaz.
  • vars.set değ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şkenler vars.get ile okunur ama pm.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.