> 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-dom/getele.md).

# getEle

### 说明

 获取指定单个`DOM`元素

### 源码

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

### 用法

{% code title="getEle.test.ts" %}

```typescript
import { getEle } from "../../utility/dom/getEle";

describe('getEle', () => {
  test('getEle should return `null` when no matched', () => {
    document.body.innerHTML = `
      <div id="app"></div>
    `;

    const origin = [
      'p', '.text'
    ];

    for (const v of origin) {
      expect(getEle(v)).toBe(null);
    }
  });

  test('getEle should return the `DOM object` which has been matched', () => {
    document.body.innerHTML = `
      <div id="#app"></div>
    `;

    const origin = ['#app'];

    for (const v of origin) {
      expect(getEle(v)).toBe(
        document.getElementById('app')
      )
    }
  });
});
```

{% endcode %}