Σχήμα JSON σε Zod
Μετατρέψτε ένα σχήμα JSON σε σχήματα Zod. Οι τύποι, οι υποχρεωτικές ιδιότητες, τα enum, τα const, τα anyOf, oneOf και allOf αντιστοιχίζονται στους builders του Zod, ενώ οι συνήθεις λέξεις-κλειδιά επικύρωσης, όπως οι minLength, maximum, pattern, format και minItems, γίνονται έλεγχοι Zod. Κάθε ορισμός γίνεται εξαγόμενο σχήμα με τύπο z.infer.
Συχνές ερωτήσεις
Ποιες λέξεις-κλειδιά επικύρωσης μετατρέπονται;
Οι minLength και maxLength γίνονται .min() και .max() σε συμβολοσειρές, το pattern γίνεται .regex(), ενώ οι μορφές email, uri, uuid και date-time γίνονται .email(), .url(), .uuid() και .datetime(). Οι minimum, maximum, exclusiveMinimum, exclusiveMaximum και multipleOf γίνονται έλεγχοι αριθμών, ενώ οι minItems και maxItems γίνονται έλεγχοι πινάκων.
Με ποια σειρά τοποθετούνται οι ορισμοί;
Κάθε ορισμός δηλώνεται πριν από τα σχήματα που τον χρησιμοποιούν. Ένας ορισμός που παραπέμπει στον εαυτό του, άμεσα ή μέσω άλλων, αναφέρεται με z.lazy ώστε ο κώδικας να εξακολουθεί να εκτελείται.
Γίνονται έλεγχοι τύπων σε αναδρομικά σχήματα;
Εκτελούνται, αλλά το TypeScript δεν μπορεί να συναγάγει τον τύπο ενός σχήματος που παραπέμπει στον εαυτό του μέσω του z.lazy. Προσθέστε ρητή δήλωση τύπου σε ένα τέτοιο σχήμα, όπως περιγράφει η τεκμηρίωση του Zod για τους αναδρομικούς τύπους.
Πώς αντιμετωπίζεται το additionalProperties;
Το additionalProperties false προσθέτει .strict(), ένα σχήμα προσθέτει .catchall() με αυτό το σχήμα, το true προσθέτει .passthrough(), ενώ ένα αντικείμενο χωρίς ιδιότητες αλλά με σχήμα additionalProperties γίνεται z.record(z.string(), ...).
Για ποια έκδοση του Zod προορίζεται ο κώδικας;
Οι builders που δημιουργούνται, όπως οι z.object, z.union, z.record με σχήμα κλειδιού και .nullable(), υπάρχουν στις εκδόσεις Zod 3 και Zod 4. Η έκδοση Zod 4 εξακολουθεί να δέχεται μεθόδους μορφοποίησης συμβολοσειρών, όπως το .email(), αν και προσφέρει επίσης το z.email() ως συντομότερη μορφή.
Τι συμβαίνει με αναφορές που δεν μπορεί να επιλύσει το εργαλείο;
Οι αναφορές εκτός του εγγράφου, όπως σε άλλο αρχείο ή σε ένα URL, γίνονται z.unknown() και καταγράφονται σε σχόλιο στην αρχή του αποτελέσματος.