---
# System prepended metadata

title: join

---

# join

:::success
join() 方法會將陣列（或一個類陣列（array-like）物件）中所有的元素連接、合併成一個字串，並回傳此字串。
:::

## 語法
```javascript=
array.join(separator)
```

### JavaScript Demo: Array.join()
```javascript=
const elements = ['Fire', 'Air', 'Water'];

console.log(elements.join());
// expected output: "Fire,Air,Water"

console.log(elements.join(''));
// expected output: "FireAirWater"

console.log(elements.join('-'));
// expected output: "Fire-Air-Water"
```

### 回傳值
一個合併所有陣列元素的字串。假如 arr.length 為 0，將回傳空字串。

### 描述
將所有陣列中的元素轉成字串型態後，連接合併成一個字串。任何 undefined 或 null 的元素都會被視為空字串處理。

###### 參考文章

> [Array.prototype.join](https://developer.mozilla.org/zh-TW/docs/Web/JavaScript/Reference/Global_Objects/Array/join)