URL

JSON

Hva gjør URL til JSON?

Du limer inn en URL til venstre, og til høyre får du et JSON-objekt der hver del av URLen har et navn — protocol, host, pathname, searchParams, hash, alt sammen. Poenget er ikke å se på det én gang og gå videre. Poenget er å kopiere den JSONen til et sted der den får leve — en config-fil, en Jest-fixture, et Postman-environment, et YAML-manifest, en request-mock til testene dine. URL-strenger er lette å skrive, men vanskelige å asserte mot; strukturerte objekter er rake motsatte.

Under panseret er det den samme algoritmen som hver nettleser bruker via URL API, som implementerer WHATWG URL Standard. Queryparametrene avkodes underveis — %20 blir et mellomrom, %5B blir [, gjentatte nøkler samles i et JSON-array — samme oppførsel du får fra URLSearchParams. Utdataen formateres så med de samme JSON.stringify-reglene som alle andre JSON-verktøy på siten bruker.

Vil du bare se på delene av en URL på skjermen — debugge en redirect, kikke gjennom en tracker-kjede — passer siden URL Parser bedre. Begge sidene gjør samme konvertering; denne her er rammet inn for tilfellet der JSONen i seg selv er artefaktet du tar vare på. Alt er lokalt i nettleseren din, ingen opplasting, ingen logger. Konverteringen følger RFC 3986 for syntaks og RFC 8259 for JSON-utdata.

Slik konverterer du en URL til JSON

Tre steg. Hvert steg svarer til en knapp på siden.

Lim inn en URL eller hent eksempelet

Slipp en URL inn i venstre panel. Klikk på Eksempel for å hente en realistisk e-handels-URL med prosentkoding, gjentatte query-nøkler og et hash-fragment. Eksempel:

https://api.shop.example.com/v1/orders?customer=Ava%20Chen&status=active&total%5Bgte%5D=49.99&page=2#summary

Alt URL-konstruktøren godtar fungerer — <code>http://</code>, <code>https://</code>, <code>file://</code>, <code>mailto:</code>, IPv6-hosts og userinfo.

Les JSON-utdataen

Høyre panel oppdateres mens du skriver. Du ser protocol, host, port, pathname, pathSegments (stien delt opp i et array), searchParams (avkodede nøkkel/verdi-par, med arrays for gjentatte nøkler) og hash. Feltet href bærer URLens kanoniske, normaliserte form — nyttig når du må verifisere at to URLer er ekvivalente selv om den ene hadde standardport eller avsluttende skråstrek.

Kopier, last ned eller minifiser til fixturen din

Klikk på Kopier for å sende JSONen til utklippstavlen, Last ned for å lagre den som url.json, eller Minifiser for å klemme den ned på én linje til en loggfølelse eller en queryparameter. Tøm i input-panelet nullstiller begge editorene.

Når du faktisk får bruk for det

Bygge fixtures for HTTP-requests

Når testene dine asserter mot en URL, er assertion mot en streng skjør — store/små bokstaver, standardporter, avsluttende skråstreker og parameterrekkefølge biter alle. Konverter URLen til JSON, legg objektet inn i fixturen din, og asserte felt for felt. Spiller fint med biblioteker som Mock Service Worker eller Nock som matcher på URL-form.

Seede API-klienter i konfigurasjonsfiler

En YAML- eller JSON-konfig som lagrer en base-URL som én streng tvinger hver konsument til å parse den på nytt. Å lagre den ferdig oppdelt (host, port, basePath, defaultParams) gjør konfigurasjonen selvdokumenterende og fjerner en hel klasse "glemte vi avsluttende skråstrek?"-bugs. Nyttig for SDK-generatorer og OpenAPI-tooling.

Dokumentasjon for OAuth- og webhook-callbacker

Når du skriver dokumentasjon som viser "callback-URLen din kommer til å se slik ut", er det mye hyggeligere for leseren å få en JSON-oppdeling ved siden av den rå URLen. Standarder som RFC 6749 krever bestemte queryparametere; en strukturert form gjør "her bør du se state" tydelig på et blunk.

Postman-/Bruno-/HTTPie-environment-eksporter

De fleste API-klienter lagrer URLer internt som oppdelte objekter. Importerer du gamle URLer inn i en ny collection — la oss si du migrerer fra en docs-side som lister endepunkter som rene strenger — lar konvertering til JSON først deg skripte importen i stedet for å klikke manuelt på 200 endepunkter.

Vanlige spørsmål

Hva er forskjellen på dette og URL Parser-siden?

Samme motor, annen innpakning. URL Parser er for inspeksjon — du limer inn en lang URL, ser på delene, bestemmer hva som er galt og lukker fanen. URL til JSON er for å ta resultatet og bruke det et annet sted — en fixture-fil, en config, et Postman-environment. JSON-utdataen er identisk; det er teksten og brukstilfellene som er trimmet for "jeg vil ha dette i en fil"-flyten.

Hvorfor er utdataen JSON i stedet for YAML eller en JS-objektliteral?

JSON er minste felles nevner — hvert språk, hvert konfigsystem og hvert testrammeverk leser det. Trenger du YAML, kjør JSONen gjennom vårt verktøy JSON til YAML. Trenger du en JS-objektliteral, er JSON allerede gyldig JS — bare lim det inn i .ts-filen din. Konverteringen følger RFC 8259, så utdataen virker alle steder JSON aksepteres.

Hvordan representeres gjentatte query-nøkler?

Gjentatte nøkler samles i et array. ?tag=red&tag=blue blir "tag": ["red", "blue"]. Det er slik Express, FastAPI, ASP.NET, Spring og de fleste rammeverk parser query strings — og det er det URLSearchParams.getAll() returnerer.

Hva med arrays i hakeparentes-notasjon, som ?items[]=1&items[]=2?

Hakeparentesene beholdes som en del av nøkkelen — du ser "items[]": ["1", "2"] i utdataen. Det er en tro representasjon av byte-ene som går over nettet. Hvis rammeverket ditt (PHP, Rails, qs.js) trenger at hakeparentesene fjernes eller utvides til et nestet objekt, gjør det i et etterbehandlingssteg på JSONen.

Inneholder JSONen passordet hvis URLen min har user:pass@host?

Ja — feltene username og password dukker opp i utdataen hvis URLen din har dem. Konverteringen kjører helt i nettleseren din, så påloggingsinformasjonen forlater aldri maskinen din. Sagt det, å legge påloggingsinformasjon i URLer er generelt en dårlig idé (se RFC 3986 §3.2.1), og du vil nesten helt sikkert fjerne dem før du commiter JSONen til et repo.

Kan jeg konvertere en liste med URLer på én gang?

Ikke på denne siden — én økt konverterer én URL. Har du hundre URLer å behandle, er den enkleste veien å lime inn utdatastrukturen fra denne siden i et lite skript og loope. Eller bruk vår JSON Formatter etter at du selv har skriptet batchen. Batchkonvertering som UI-funksjon ligger i veikartet, men er ikke levert ennå.

Andre URL- og JSON-verktøy

Konvertering er bare én operasjon. Dette passer naturlig sammen med den: