append() เป็น n8n-specific array extension (ไม่ใช่ JavaScript method มาตรฐาน) เพิ่มค่าหรือรายการใหม่ต่อท้ายอาร์เรย์ คืนค่าเป็นอาร์เรย์ใหม่ (immutable – ไม่แก้ไขอาร์เรย์เดิม) มีประโยชน์ในการเพิ่มรายการใหม่ รวมข้อมูลจากหลายแหล่ง หรือสร้างอาร์เรย์แบบ incremental
=array.append(value)
=array.append(value)
| Argument | Type | Required | Default | Description |
|---|---|---|---|---|
| value | any | Yes | ค่าที่ต้องการเพิ่มต่อท้ายอาร์เรย์ (สามารถเป็น string, number, object, หรือ array ก็ได้) |
เพิ่มข้อมูลใหม่ที่รับจาก API call ต่อท้ายอาร์เรย์ที่มีอยู่
เพิ่มรายการจากแหล่งข้อมูลต่างๆ เข้าด้วยกันเป็นอาร์เรย์เดียว
เพิ่ม log entry ใหม่ต่อท้าย log array สำหรับ tracking
{{ [1, 2, 3].append(4) }}={{ [1, 2, 3].append(4) }}
[1, 2, 3, 4]
{{ [{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }].append({ id: 3, name: 'Bob' }) }}={{ [{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }].append({ id: 3, name: 'Bob' }) }}
[{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }, { id: 3, name: 'Bob' }]
{{ [].append('first item') }}={{ [].append('first item') }}
['first item']
{{ [1, 2].append(3).append(4).append(5) }}={{ [1, 2].append(3).append(4).append(5) }}
[1, 2, 3, 4, 5]
append() คืนค่าอาร์เรย์ใหม่ (immutable, ไม่แก้ไขอาร์เรย์เดิม) ส่วน push() แก้ไขอาร์เรย์เดิมโดยตรง (mutable) ใน n8n ส่วนใหญ่ใช้ append() เพราะรักษา immutability ของ expressions
ไม่ append() เพิ่มทีละ 1 ค่า ถ้าต้องการเพิ่มหลายค่าใช้ chain: array.append(1).append(2).append(3) หรือใช้ concat() เพื่อรวม 2 arrays: [1,2].concat([3,4,5])
append() เพิ่มค่าเดียว (เช่น item หรือ array as single element) ส่วน concat() รวม arrays (flatten elements) เช่น [1,2].append([3,4]) ได้ [1,2,[3,4]] แต่ [1,2].concat([3,4]) ได้ [1,2,3,4]
ใช้เมื่อต้องการเพิ่มรายการเดียวต่อท้ายอาร์เรย์ เช่น เพิ่มข้อมูลใหม่จาก API สร้าง log entries หรือรวมรายการจากหลายแหล่ง ใช้ concat() แทนถ้าต้องการรวม arrays ใช้ push() ถ้าต้องการแก้ไขอาร์เรย์เดิม (ไม่แนะนำใน n8n)
append() เป็น n8n-specific array extension ที่เพิ่มค่าหรือรายการใหม่ต่อท้ายอาร์เรย์ คืนค่าเป็นอาร์เรย์ใหม่ที่มีค่าเดิมบวกกับค่าที่เพิ่มเข้าไป ไม่แก้ไขอาร์เรย์เดิม