Jak odzyskać obiekty z JSON, tak aby metadane zostały…

Aby przywrócić obiekty z zapisanymi metadanymi z JSON, można użyć metody JSON.parse() w połączeniu z funkcją reviver. Reviver to opcjonalna funkcja wywoływana dla każdej pary klucz-wartość podczas analizy JSON. Pozwala na modyfikację zdekodowanych wartości przed ich zwróceniem.

Przykład użycia reviver do zachowania typu:

const jsonString = '{"date": "2023-10-27T10:00:00.000Z", "regexp": "/test/i"}';

const restoredObject = JSON.parse(jsonString, (key, value) => {
  if (typeof value === 'string' && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{3}Z$/.test(value)) {
    return new Date(value);
  }
  if (typeof value === 'string' && /^\/.+\/[gimyus]*$/.test(value)) {
    try {
       const match = value.match(/^\/(.+)\/([gimyus]*)$/);
       if (match) {
           return new RegExp(match[1], match[2]);
       }
    } catch (e) {
    }
  }
  return value;
});

console.log(restoredObject.date instanceof Date); // true
console.log(restoredObject.regexp instanceof RegExp); // true

Dla bardziej złożonych przypadków, gdzie metadane mogą zawierać informacje o niestandardowych klasach lub innych typach, konieczne jest dodanie jawnych markerów lub schematu w JSON opisującego typy danych.

Przykład z jawnie zdefiniowanymi markerami:

{
  "user": {
    "_type": "User",
    "name": "Alice",
    "registrationDate": {
      "_type": "Date",
      "value": "2023-10-26T12:00:00.000Z"
    }
  },
  "settings": {
    "theme": "dark"
  }
}

I odpowiadający reviver:

class User {
  constructor(name, registrationDate) {
    this.name = name;
    this.registrationDate = registrationDate;
  }
}

const jsonWithMetadata = '{"user": {"_type": "User", "name": "Alice", "registrationDate": {"_type": "Date", "value": "2023-10-26T12:00:00.000Z"}}, "settings": {"theme": "dark"}}';

const restoredObjectWithMetadata = JSON.parse(jsonWithMetadata, (key, value) => {
  if (value && typeof value === 'object' && value._type) {
    switch (value._type) {
      case 'Date':
        return new Date(value.value);
      case 'User':
        return new User(value.name, new Date(value.registrationDate.value));
      default:
        return value;
    }
  }
  return value;
});

console.log(restoredObjectWithMetadata.user instanceof User); // true
console.log(restoredObjectWithMetadata.user.registrationDate instanceof Date); // true

Ten sposób wymaga wcześniejszego uzgodnienia struktury metadanych w JSON (np. użycia klucza _type) oraz implementacji logiki przywracania w reviverze dla każdego typu. Dla złożonych obiektów, takich jak instancje niestandardowych klas z metodami, konieczne może być bardziej zaawansowane podejście, obejmujące serializację i deserializację metod osobno lub korzystanie z bibliotek specjalistycznych. Jednak dla standardowych typów i prostych struktur danych, reviver jest wystarczająco skuteczny.

Jak odzyskać obiekty z JSON, tak aby metadane zostały zachowane?