Issue #3383692 by Murz, xjm, smustgrave: Document that NULL is an allowed...

Issue #3383692 by Murz, xjm, smustgrave: Document that NULL is an allowed return value for EntityRepositoryInterface::getTranslationFromContext() (cherry picked from commit 731c7344)

Issue #3383692 by Murz, xjm, smustgrave: Document that NULL is an allowed...
56cfeaf5 · Jess · 3cc2d752 · 56cfeaf5
Verified Commit 56cfeaf5 authored 1 year ago by Jess
--- a/core/lib/Drupal/Core/Entity/EntityRepositoryInterface.php
+++ b/core/lib/Drupal/Core/Entity/EntityRepositoryInterface.php
@@ -64,8 +64,9 @@ public function loadEntityByConfigTarget($entity_type_id, $target);
   *   (optional) An associative array of arbitrary data that can be useful to
   *   determine the proper fallback sequence.
   *
-   * @return \Drupal\Core\Entity\EntityInterface
+   * @return \Drupal\Core\Entity\EntityInterface|null
-   *   An entity object for the translated data.
+   *   An entity object for the translated data, or NULL if the requested
+   *   translation is missing, forbidden, or unavailable.
   *
   * @see \Drupal\Core\Language\LanguageManagerInterface::getFallbackCandidates()
   */