Vigtigste punkter
- 01Drevet af Ajv, det mest bredt brugte JavaScript JSON-skema-validator — det der passerer her passerer i Node.js, Fastify og de fleste JS-værktøjskæder.
- 02Rapporterer hver valideringsfejl på en gang (allErrors mode), ikke kun det første fejl.
- 03Hver fejl inkluderer JSON Pointer-stien til det fejlende felt for hurtig navigation.
- 04Både skema og data kørende fuldstændigt i din browser — intet uploadet.
Hvorfor validerer du JSON mod et skema?
JSON-skema er standard-måden at beskrive formen på et JSON-dokument — påkrævede felter, tilladte typer, værdibegrænsninger, indlejrede objekt-strukturer. Validering mod et skema før en payload når produktion fanger type-mismatch, manglende påkrævede felter og constraint-overtrædelser tidligt, når de er billige at rette.
De mest almindelige use cases er testing af API-anmodning og svar-bodies, validering af konfigurationsfiler, kontrol af OpenAPI-eksempel-objekter og verifikation af data-eksporter mod en kendt struktur. Handytools validator bruger Ajv — de facto JavaScript JSON-skema-biblioteket, brugt inde i Node.js selv — så resultaterne her matcher hvad din backend vil se.
Sådan validerer du JSON mod et skema
- 01
Indsæt dit JSON-skema
Indsæt skemaet i venstre panel. Dette kan være et Draft 7 eller 2019-09 eller 2020-12 skema med type, properties, required, items, anyOf, allOf — ethvert standard Ajv-understøttet søgeord.
- 02
Indsæt dine JSON-data
Indsæt det datadokument du ønsker at validere i højre panel. Dette er instansen — en API-anmodning body, et config-objekt, en eksport-record eller et enkelt eksempel fra din OpenAPI spec.
- 03
Klik Validér
Ajv kører validering med allErrors: true, hvilket betyder det indsamler hver fejl i stedet for at stoppe ved den første.
- 04
Gennemse fejllisten
Hver fejl viser JSON Pointer-stien til den fejlende værdi (f.eks. /user/email), det fejlende søgeord (type, required, minimum) og en menneske-læsbar meddelelse. Ret hver og re-validér.
Hvad udviklere validerer med JSON-skema
- 01REST API-anmodning bodies — bekræft en payload matcher endepunktets forventede form før sending.
- 02OpenAPI spec-eksempel-objekter — valider hver eksempel mod inline skema-komponenten.
- 03Konfigurationsfiler — sikr påkrævede nøgler er til stede og værdier er den rigtige type.
- 04Data pipeline-records — spot strukturelt drift mellem data-producenter og forbrugere.
- 05Formular submission payloads — test at frontend-validering afspejler backend-skema-constraints.
- 06Tredjepartswebhook-bodies — bekræft den dokumenterede skema matcher den faktiske payload.
Privat validering, ingen server påkrævet
Ajv kørende fuldstændigt i din browser. Hverken skemaet eller dataene sendes til nogen server — du kan sikkert validere skemaer der beskriver indre datastrukturer og data-objekter der indeholder sensitive feltværdier.
Validatoren understøtter JSON-skema drafts 6, 7, 2019-09 og 2020-12. Den mest almindelige draft i det vilde er Draft 7, som dækker alle daglige søgeord: type, properties, required, items, minimum, maximum, pattern, enum, anyOf, allOf, oneOf, not og $ref.
JSON-skema-validator FAQ
Hvilke JSON-skema drafts understøttes?
Ajv understøtter drafts 6, 7, 2019-09 og 2020-12. Draft 7 er den mest almindelige i eksisterende kodebaser og dækker alle standard søgeord.
Hvorfor løses min $ref-skema ikke?
Eksterne $ref URL-er hentes ikke i dette browser-only værktøj. Inline alle henviste skemaer ved hjælp af $defs og lokale JSON-pointers som #/$defs/MyType.
Bliver mit skema eller data uploadet til nogen server?
Nej. Ajv kørende fuldstændigt i din browser — både skema og data forbliver på din enhed.
Kan jeg bruge dette til at validere en OpenAPI 3 spec?
Du kan validere individuelle skema-komponenter og eksempel-objekter. Validering af hele OpenAPI-dokumentet kræver en dedikeret OpenAPI-validator der forstår spec meta-skemaet.
Hvorfor ser jeg flere fejl i stedet for bare den første?
Validatoren er konfigureret med allErrors: true, som får Ajv til at indsamle hver fejl i stedet for at stoppe ved den første. Dette er bevidst — du kan rette alle problemer i et pass i stedet for at lave gentagne validerings-forsøg.