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}
が返されます。