Return types have changed on some JSON:API Normalizer methods

By godotislate on 1 May 2026

Change record status:

Published (View all published change records)

Project:

Introduced in branch:

11.4.x

Introduced in version:

11.4.0

Issue links:

https://www.drupal.org/node/3563533

Description:

The following methods have had changes to their return type declarations:

Drupal\serialization\Normalizer\ComplexDataNormalizer

Before: public function normalize($object, $format = NULL, array $context = []): array|string|int|float|bool|\ArrayObject|NULL
After: public function normalize($object, $format = NULL, array $context = []): array

Drupal\serialization\Normalizer\ConfigEntityNormalizer

Before: public function normalize($object, $format = NULL, array $context = []): array|string|int|float|bool|\ArrayObject|NULL
After: public function normalize($object, $format = NULL, array $context = []): array

Drupal\serialization\Normalizer\ContentEntityNormalizer

Before: public function normalize($object, $format = NULL, array $context = []): array|string|int|float|bool|\ArrayObject|NULL
After: public function normalize($object, $format = NULL, array $context = []): array

Drupal\serialization\Normalizer\EntityReferenceFieldItemNormalizer

Before: public function normalize($object, $format = NULL, array $context = []): array|string|int|float|bool|\ArrayObject|NULL
After: public function normalize($object, $format = NULL, array $context = []): array

Drupal\serialization\Normalizer\ListNormalizer

Before: public function normalize($object, $format = NULL, array $context = []): array|string|int|float|bool|\ArrayObject|NULL
After: public function normalize($object, $format = NULL, array $context = []): array

Drupal\serialization\Normalizer\MarkupNormalizer

Before: public function normalize($object, $format = NULL, array $context = []): array|string|int|float|bool|\ArrayObject|NULL
After: public function normalize($object, $format = NULL, array $context = []): string

Drupal\serialization\Normalizer\NullNormalizer

Before: public function normalize($object, $format = NULL, array $context = []): array|string|int|float|bool|\ArrayObject|NULL
After: public function normalize($object, $format = NULL, array $context = []): null

Drupal\serialization\Normalizer\TimestampItemNormalizer

Before: public function normalize($object, $format = NULL, array $context = []): array|string|int|float|bool|\ArrayObject|NULL
After: public function normalize($object, $format = NULL, array $context = []): array

Impacts:

Module developers