Articles sur : Blocs Celestory

🟪 Récupérer d'un Objet

🟪 Récupérer d'un Objet



Récupérer d'un Objet


Le bloc Récupérer d'un Objet permet de lire une valeur précise à l'intérieur d'une variable de type Objet (une donnée structurée en clé/valeur, comme un JSON).


C'est l'équivalent du bloc "Récupérer d'une liste", mais pour des données identifiées par un nom plutôt que par une position. Il est utile pour lire une information précise dans une fiche joueur, une réponse d'API, ou toute autre donnée structurée importée dans le projet.


📥 Entrées


  • objet (Objet) : La variable de type Objet dans laquelle chercher.
  • chemin (Texte) : Le chemin vers la valeur recherchée dans l'objet (ex : score, nom, ou adresse.ville pour une valeur imbriquée).
  • défaut (Texte, Nombre, Booléen, Liste ou Objet) : La valeur renvoyée si le chemin est introuvable (ou si la valeur trouvée est vide/null).


📤 Sorties


  • valeur (Variable dynamique) : La valeur trouvée au chemin demandé. Son type s'ajuste automatiquement selon ce qui est trouvé (texte, nombre, liste, objet imbriqué...).
  • trouvé (Booléen) : true si une valeur a été trouvée au chemin demandé (une valeur null compte comme "non trouvée").


💡 Exemple d'utilisation


Scénario : Afficher le score d'un joueur reçu depuis une API


  1. Une requête HTTP renvoie un objet joueur contenant {"nom": "Alice", "score": 1200}.
  2. Vous voulez afficher seulement le score dans une bulle de dialogue.
  3. Ajoutez un bloc Récupérer d'un Objet, et reliez la variable objet reçue à l'entrée objet.
  4. Tapez score dans l'entrée chemin.
  5. La sortie valeur renvoie 1200, prête à être affichée ou utilisée dans la suite du flux.


⚙️ Détails Techniques


  • Identifiant interne : getFromObject
  • Chemins imbriqués : Pour accéder à une propriété imbriquée, on utilise un chemin en notation pointée (ex : adresse.ville) ou avec des crochets pour un élément de liste (ex : items[0].id).
  • Valeur introuvable : Si le chemin ne mène à aucune valeur (ou à une valeur vide), la sortie valeur renvoie la valeur défaut et la sortie trouvé indique false — plutôt que de casser le flux silencieusement.



Version documentée : v3

Mis à jour le : 23/09/2026

Cet article a-t-il répondu à vos questions ?

Partagez vos commentaires

Annuler

Merci !