Pole `Board.creator` może teraz mieć wartość null w wersji API 2027-04

Pole creator w obiekcie Board zwraca teraz User zamiast User!, więc może mieć wartość null. Zaktualizowano też opis pola: „Twórca tablicy. Zwraca wartość null, jeśli nie można ustalić twórcy”.

Wcześniej schemat gwarantował, że dla każdej tablicy można ustalić jej twórcę. Jeśli nie dało się ustalić twórcy, pole, które nie może mieć wartości null, nie mogło zwrócić null. W rezultacie żądanie mogło zakończyć się niepowodzeniem lub zwrócić błąd dotyczący tej tablicy. Gdy pole creator może mieć wartość null, w takiej sytuacji zwraca null, a pozostałe dane tablicy pozostają bez zmian.

To niezgodna wstecznie zmiana dla klientów, którzy polegają na typie, który nie może mieć wartości null. Dotyczy to na przykład kodu wygenerowanego ze schematu, w którym creator nie może mieć wartości null, oraz kodu, który odczytuje creator.id lub creator.name bez sprawdzania. Traktuj pole creator jako opcjonalne: przed odczytaniem jego pól sprawdź, czy nie ma wartości null, i wygeneruj ponownie typy utworzone na podstawie schematu dla wersji 2027-04.

query {
  boards(ids: [1234567890]) {
    id
    creator {
      id
      name
    }
  }
}

Jeśli nie można ustalić twórcy, tablica nadal jest zwracana, a pole creator ma wartość null. Odczytuj creator.id i creator.name dopiero po sprawdzeniu, że creator nie ma wartości null:

{
  "data": {
    "boards": [
      {
        "id": "1234567890",
        "creator": null
      }
    ]
  }
}

Szczegółowe informacje o obiekcie Board znajdziesz w dokumentacji tablic. Pełną listę zmian w poszczególnych wersjach znajdziesz w informacjach o wydaniach API.