Set
オブジェクトのキーを指定された値に設定します。キーが存在しない場合は新たに作成されます。
入力フィールド
-
object(オブジェクト):元のオブジェクト。
-
path(パス):単一のトップレベルのキー名(例:「customer」)、またはドット区切りパス(例:「customer.id」で、「id」はサブオブジェクト内のキー、または「items.5」で、5はリスト内の要素)を使用できます。またはpath(パス)の型を変更し、テキストのリストを受け付け、各テキストがパスの単一のキー名を含むようにすることもできます。
-
value(値):キーの新しい値。value(値)の型は、キーに要求される型 (例:テキストまたは数値) と必ず一致するよう設定してください。
出力フィールド
- output(出力):指定されたパスの値が更新された、新しいオブジェクト。
例
object(オブジェクト)が{"foo":"1"}、path(パス)がfoo、value(値)が2なら、output(出力)は{"foo":"2"}です。
object(オブジェクト)が{"foo":"1"}、path(パス)がbar、value(値)が2なら、output(出力)は{"foo":"1","bar":"2"}です。
object(オブジェクト)が{"foo":"1"}、path(パス)がbar.baz、value(値)が2なら、output(出力)は{"foo":"1","bar":{"baz":"2"}}です。
object(オブジェクト)が{"foo":["0","1","2"]}、path(パス)がfoo.1、value(値)が9なら、output(出力)は{"foo":["0","9","2"]}です。
object(オブジェクト)が{"foo":{"bar":"1"}}、path(パス)がfoo.bar、value(値)が2なら、output(出力)は{"foo":{"bar":"2"}}です。
または、path(パス)の型をテキストのリストに設定し、「foo」と「bar」をリストのアイテムとして渡しても、同じ結果を得ることができます。
テキストのリストを使用する場合、ドットは目的のキー名の一部と想定されるため、path(パス)がリストに設定されているときfoo.barを入力として使用すると、output(出力){"foo":{"bar":1},"foo.bar":2}が返されます。
