Com crear un fitxer .JSON amb el Bloc de notes

El JSON és text pla amb regles estrictes. El Bloc de notes pot escriure'l perfectament. El que la gent fa malament és la sintaxi, no l'eina. Si aconsegueixes la estructura correcta, desar el fitxer és la part fàcil.

Què és un fitxer JSON?

JSON significa JavaScript Object Notation (Notació d'Objectes de JavaScript). Emmagatzema dades com a parells clau-valor dins de claus, amb suport per a objectes imbricats i matrius (arrays). Les aplicacions, les API i els fitxers de configuració l'utilitzen perquè és lleuger i qualsevol llenguatge important pot llegir-lo.

Un fitxer JSON bàsic té aquest aspecte:

{

  "name": "John",

  "age": 28,

  "isActive": true,

  "skills": ["writing", "editing"]

}

Pas a pas: Crea un fitxer JSON al Bloc de notes

Pas 1: Obre el Bloc de notes

Obre el Bloc de notes al teu ordinador, o utilitza un Bloc de notes en línia gratuït des de qualsevol navegador.

Pas 2: Comença amb una clau d'obertura

Cada fitxer JSON comença amb { per a un objecte o [ per a una matriu (array). La majoria de fitxers comencen amb un objecte.

Pas 3: Afegeix les teves claus i valors

Escriu cada clau entre cometes dobles, seguida d'uns dos punts i, a continuació, el valor. Separa cada parell amb una coma.

{

  "title": "Sample File",

  "version": 1

}

Pas 4: Tanca el fitxer correctament

Fes coincidir cada clau o claudàtor d'obertura amb un de tancament. L'últim parell clau-valor d'un objecte o matriu no porta coma final.

Pas 5: Desa amb una extensió .json

Vés a Fitxer i, a continuació, Anomena i desa. Tria «Tots els fitxers» al menú desplegable «Tipus». Posa un nom al fitxer amb l'extensió .json, per exemple data.json. Si el deses sense canviar aquest menú desplegable, obtindràs un fitxer .txt que no es llegirà com a JSON.

Pas 6: Valida'l abans d'utilitzar-lo

Enganxa el fitxer en un editor JSON per confirmar que és vàlid abans d'utilitzar-lo en un script o aplicació. Una comprovació ràpida aquí t'evita haver de depurar errors més endavant.

Regles de sintaxi JSON a recordar

• Només cometes dobles. Les claus i els valors de text necessiten cometes dobles, no cometes simples.

• Sense comes finals. Res no segueix l'últim element d'un objecte o matriu.

• Sense comentaris. El JSON estàndard no admet notes // o /* */ dins del fitxer.

• Els booleans van en minúscules. Utilitza true i false, no True o FALSE.

• Els números no necessiten cometes. Escriu 28, no "28", tret que el valor hagi de ser text.

Errors comuns i com evitar-los

Problema: Manca una coma entre els parells clau-valor. Solució: Cada parell, excepte l'últim, necessita una coma al final.

Problema: Claudàtors o claus mal emparellats. Solució: Compta els teus parells {} i []. Un validador assenyalarà exactament la línia on no coincideixen.

Problema: Cometes no escapades dins d'una cadena de text. Solució: Escapa les cometes internes amb una barra invertida, per exemple "He said \"hello\"".

Problema: Una clau sense cometes. Solució: Cada clau s'ha d'envoltar de cometes dobles, fins i tot les més senzilles com id o name.

Conclusió

Un fitxer JSON és només text que segueix un format estricte. Escriu les teves claus i valors entre cometes dobles, emparella els claudàtors, passa de la coma final i desa'l amb una extensió .json. Passa'l per un validador un cop abans d'utilitzar-lo, i ja estaràs a punt.