Définir

Définit une clé d'un objet à une valeur spécifiée, créant une nouvelle clé si elle n'existe pas déjà.

Champs d'entrée

  • objet : l'objet avec lequel vous commencez

  • chemin : peut être un seul nom de clé de niveau supérieur (par exemple, "customer"), un chemin délimité par des points (p. ex., "customer.id" où "id" est une clé à l'intérieur d'un sous-objet ou "items.5" où 5 est un élément à l'intérieur d'une liste), ou vous pouvez changer le type de chemin pour qu'il accepte une liste de texte contenant chacun un seul nom de clé pour le chemin

  • valeur : la nouvelle valeur de la clé. Assurez-vous de définir le type de valeur pour qu'il corresponde au type souhaité (p. ex., texte ou nombre) pour la clé.

Champs de sortie

sortie : le nouvel objet contenant la valeur mise à jour dans le chemin spécifié

Exemples

Si objet est {"foo":"1"}, chemin est foo, et valeur est 2, alors sortie est {"foo":"2"}.

Si objet est {"foo":"1"}, chemin est bar, et valeur est 2, alors sortie est {"foo":"1","bar":"2"}.

Si objet est {"foo":"1"}, chemin est bar.baz, et valeur est 2, alors sortie est {"foo":"1","bar":{"baz":"2"}}.

Si objet est {"foo":["0","1","2"]}, chemin est foo.1, et valeur est 9, alors sortie est {"foo":["0","9","2"]}.

Si objet est {"foo":{"bar":"1"}}, chemin est foo.bar et valeur est 2, alors sortie est {"foo":{"bar":"2"}}.

Autrement, vous pouvez définir le type de chemin comme étant une liste de texte, puis transmettre "foo" et "bar" comme éléments de la liste pour obtenir le même résultat.

Lorsque vous utilisez une liste de texte, on suppose que les points font partie du nom de clé souhaité; donc, utiliser foo.bar comme entrée si chemin est défini comme une liste donnerait la sortie {"foo":{"bar":1},"foo.bar":2}