Aller au contenu

Sesije snimanja

Sesija snimanja promatra web-stranicu dok je koristite i bilježi svaki API poziv koji ona upućuje: REST, GraphQL, gRPC-web i WebSocket. Zabilježeni pozivi pregledavaju se kao obični odgovori, a u planovima Pro i Enterprise pretvaraju se u mapu pravih zahtjeva koji se mogu ponovno izvesti, unaprijed ispunjenih onim što je stranica stvarno poslala.

To je najkraći put do dokumentiranja API-ja od kojega imate samo front-end: nema proxyja za podešavanje, nema certifikata za instalaciju, nema proširenja preglednika.

Sesija se stvara bilo gdje u stablu — u korijenu, u mapi ili u mapi okruženja — iz kontekstnog izbornika („Dodaj“ → „Sesija snimanja“) ili iz izbornika „Stvori“; jedino je scenarij ne može sadržavati. U bočnoj traci prikazuje se kao nadređeni čvor: klik na samu sesiju otvara njezinu stranicu s postavkama, a svaki od njezinih podređenih redaka otvara vlastitu karticu.

Stranica s postavkama sesije snimanja: url stranice, protokoli koji se bilježe, bijela i crna lista te gumb Pokreni snimanje

Postavke se svode na četiri stavke:

  • Url stranice koja se otvara u mini pregledniku (http://, https:// ili file://). Gumb Pokreni snimanje ostaje onemogućen dok url nije valjan.
  • Protokoli za bilježenje: HTTP, WebSocket, GraphQL, gRPC-web — svi su zadano označeni.
  • Bijela lista: regularni izrazi; poziv se zadržava ako odgovara barem jednom od njih. Prazna lista propušta sve.
  • Crna lista: regularni izrazi; poziv koji odgovara bilo kojem od njih odbacuje se. Crna lista uvijek ima posljednju riječ.

U datoteku projekta spremaju se samo te postavke i izvedene rute. Zabilježeni pozivi ostaju u memoriji: nestaju pri zatvaranju projekta i nikada se ne zapisuju na disk.

Gumb Pokreni snimanje otvara stranicu u kartici mini preglednika i priključuje snimač prije prvog učitavanja, tako da se bilježe i pozivi koje stranica upućuje pri pokretanju — uključujući WebSocket vezu otvorenu odmah. Pulsirajući sjaj oko oznake sesije u bočnoj traci i oko njezine kartice pokazuje da je snimanje u tijeku.

Mini preglednik tijekom snimanja: stranica web-mjesta, gumbi Pauziraj snimanje i Zaustavi snimanje u adresnom retku, crvena oznaka na sesiji

Pregledavajte i koristite stranicu kao i inače. Sesijom upravljaju dva gumba u adresnom retku:

  • Pauziraj snimanje zadržava stranicu otvorenom, ali više ne pohranjuje pozive — praktično za preskakanje nezanimljivog zaslona.
  • Zaustavi snimanje odspaja snimač i zatvara karticu preglednika. Snimke ostaju dostupne.

Snimanje je uvijek izričita radnja: kartica preglednika vraćena pri ponovnom otvaranju aplikacije ne snima ništa.

Web-stranice koje trebaju vašu lokaciju traže je od preglednika, a mini preglednik prema zadanim postavkama ne otkriva ništa. Postavka Dijeljenje vaše lokacije s ugrađenim preglednikom, u odjeljku Privatnost postavki aplikacije i isključena prema zadanim postavkama, daje vašu približnu lokaciju nakon što zatraži vaš pristanak — iz sustavske usluge lociranja, a u suprotnom iz procjene na razini grada na temelju vaše IP adrese. Njezino isključivanje odmah zaboravlja lokaciju.

Redak „Snimke“ sesije otvara prikaz poziva, grupiranih po izvođenju od najstarijeg do najnovijeg i ažuriranih uživo tijekom snimanja. Dok je popis pomaknut do samog dna, prati najnovije pozive; pomaknite se prema gore da biste jedan pročitali i popis ostaje na mjestu. Polje za filtriranje sužava popis; detalji poziva koriste točno iste kartice odgovora kao i zahtjevi (tijelo, informacije, kolačići, graf), protokol po protokol.

Prikaz snimaka: lijevo popis poziva grupiranih po izvođenju, desno detalji odabranog poziva s njegovim karticama odgovora

Kontekstni izbornik poziva nudi njegovo dodavanje na bijelu ili crnu listu, s njegovim url-om unaprijed ispunjenim kao uzorkom. Novi uzorak možete primijeniti i na već zabilježene pozive: oni koji više ne prolaze brišu se, trajno — aplikacija traži potvrdu.

Broj poziva zadržanih po sesiji ograničen je (zadano 1.000, podesivo u postavkama aplikacije); iznad toga najstariji se brišu.

U planovima Pro i Enterprise gumb Izvedi rute u prikazu snimaka pretvara pozive u stablo ispod retka „Rute“ sesije:

  • pozivi se grupiraju po ruti: segment putanje koji se mijenja od poziva do poziva (/pets/1, /pets/2) postaje parametar putanje {{petId}};
  • mape slijede statičke prefikse putanja (api › pets); gRPC-web pozivi razvrstavaju se po servisu;
  • svaka ruta postaje običan zahtjev — HTTP, GraphQL, gRPC-web ili WebSocket — unaprijed ispunjen iz posljednjeg uspješnog poziva (zaglavlja, parametri, tijelo) i odmah spreman za ponovno izvođenje;
  • zabilježeni pozivi unose se u povijest odgovora svakog zahtjeva, u uobičajenom formatu i unutar podešenog ograničenja zadržavanja; zadano se prikazuje odgovor posljednjeg uspješnog poziva.

Prošireni redak Rute sesije: izvedene mape i njihovi zahtjevi, spremni za ponovno izvođenje

Ponovno izvođenje nakon novih snimanja spaja: dodaju se samo nove rute, a postojeći zahtjevi — uključujući one koje ste izmijenili — ostaju netaknuti.

U planu Community snimanje i pregled snimaka potpuno su dostupni; kartica Rute prikazuje podsjetnik na značajku plana Pro.

Cijela je značajka dostupna putem Restormova MCP poslužitelja: stvaranje i podešavanje sesije, pokretanje i zaustavljanje snimanja, čitanje snimaka i izvođenje ruta. Agent tako može otvoriti stranicu, pustiti je da radi, a zatim predati mapu zahtjeva spremnih za uporabu.