> For the complete documentation index, see [llms.txt](https://ddzy.gitbook.io/ts-utility-plugins-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ddzy.gitbook.io/ts-utility-plugins-docs/utility/utility-array/_concat.md).

# \_concat

### 说明

将给定的任意数量的值追加至源数组

### 源码

<https://github.com/ddzy/ts-utility-plugins/tree/master/src/ddzy/utility/array/_concat>

### 用法

{% code title="\_concat.test.ts" %}

```typescript
import { _concat } from "../../utility/array/_concat";

describe('_concat', () => {
  test('_concat should return an new array being composed of number', () => {
    const received = [1, 2, 3, 4, 5];
    const expected = [1, 2, 3, 4, 5, 6, 7, 8];

    const result = _concat<number>(received, 6, 7, 8);

    for (const [i, v] of result.entries()) {
      expect(v).toBe(expected[i]);
    }

    // Should not change the origin array
    expect(received.length).toBe(5);
  });

  test('_concat should return an new array being composed of any value', () => {
    const received: any[] = [1, 0, '', undefined, null, [[100]], { name: 'ddzy' }];
    const expected = 10;

    const result = _concat<any>(received, [[200], [300]], { age: 21 });

    expect(result.length).toBe(expected);
  });
});
```

{% endcode %}