查询相关 API
类型说明
TWaitforParams:
属性 | 类型 | 必须 | 默认值 | 说明 | |
---|---|---|---|---|---|
container | HTMLElement | window.document | 查询的 root 节点 | ||
timeout | number | 1000 | 失效时间 | ||
interval | number | 50 | 查询间隔 | ||
mutationObserverOptions | MutationObserverInit | {subtree: true, childList: true, attributes: true, characterData: true } | 监听器参数 |
按照选择器查询
querySelector
function querySelector(selectors: string): HTMLElement
参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
selectors | string | 是 | 选择器,同 docuemt.querySelector 一致 |
用法:
const btns = testUtils.queries.querySelectorAll('.btns')
querySelectorAll
function querySelectorAll(selectors: string): HTMLElement[]
参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
selectors | string | 是 | 选择器,同 docuemt.querySelectorAll 一致 |
用法:
const btns = testUtils.queries.querySelectorAll('.btns')
waitForQuerySelector
async function waitForQuerySelector(selectors: string, params?: TParams): Promise<HTMLElement>
参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
selectors | string | 是 | 选择器,同 docuemt.querySelector 一致 |
params | TWaitforParams | 参数:见 TWaitforParams 说明 |
用法:
const btn = await testUtils.queries.waitForQuerySelector('.async-btn')
waitForQuerySelectorAll
async function waitForQuerySelectorAll(selectors: string, params?: TParams): Promise<HTMLElement[]>
参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
selectors | string | 是 | 选择器,同 docuemt.querySelectorAll 一致 |
params | TWaitforParams | 参数:见 TWaitforParams 说明 |
用法:
const btns = await testUtils.queries.waitForQuerySelectorAll('.async-btns')
按照文本查询
queryByText
function queryByText(text: string, selector?: string): HTMLElement
参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
text | string | 是 | 文本内容,部分匹配即可 |
selector | string | 选择器,同 docuemt.querySelector 一致 |
用法:
// <Text>Hello World!!!</Text>
const textView = testUtils.queries.queryByText('Hello World')
queryByTextAll
function queryAllByText(text: string, selector?: string): HTMLElement[]
参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
text | string | 是 | 文本内容,部分匹配即可 |
selector | string | 选择器,同 docuemt.querySelector 一致 |
用法:
// <Text>Hello World!!</Text>
// <View>Hello World!!!</View>
const textViews = testUtils.queries.queryAllByText('Hello World')
waitForQueryByText
async function waitForQueryByText(text: string, selector?: string, params?: TWaitforParams): HTMLElement
参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
text | string | 是 | 文本内容,部分匹配即可 |
selector | string | 选择器,同 docuemt.querySelector 一致 | |
params | TWaitforParams | 参数:见 TWaitforParams 说明 |
用法:
// <Text>Hello World!!!</Text>
const textView = async testUtils.queries.waitForQueryByText("Hello World");
waitForQueryAllByText
async function waitForQueryAllByText(text: string, selector?: string, params?: TWaitforParams): HTMLElement[]
参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
text | string | 是 | 文本内容,部分匹配即可 |
selector | string | 选择器,同 docuemt.querySelector 一致 | |
params | TWaitforParams | 参数:见 TWaitforParams 说明 |
用法:
// <Text>Hello World!!</Text>
// <View>Hello World!!!</View>
const textViews = async testUtils.queries.waitForQueryAllByText("Hello World");
按照 Placeholder 查询
queryByPlaceholder
function queryByPlaceholder(text: string): HTMLElement
参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
text | string | 是 | placeholder 内容 |
用法:
// <input placeholder="hello" />
const input = testUtils.queries.queryByPlaceholder('hello')
queryAllByPlaceholder
function queryAllByPlaceholder(text: string): HTMLElement[]
参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
text | string | 是 | placeholder 内容 |
用法:
// <input placeholder="hello" />
// <input placeholder="hello" />
const inputs = testUtils.queries.queryAllByPlaceholder('hello')
waitForQueryByPlaceholder
async function waitForQueryByPlaceholder(text: string, params?: TParams): Promise<HTMLElement>
参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
text | string | 是 | placeholder 内容 |
params | TWaitforParams | 参数:见 TWaitforParams 说明 |
用法:
// <input placeholder="async-placeholde" />
const input = await testUtils.queries.waitForQueryByPlaceholder('async-placeholder')
waitForQueryAllByPlaceholder
async function waitForQueryAllByPlaceholder(text: string, params?: TParams): Promise<HTMLElement[]>
参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
text | string | 是 | placeholder 内容 |
params | TWaitforParams | 参数:见 TWaitforParams 说明 |
用法:
// <input placeholder="async-placeholde" />
// <input placeholder="async-placeholde" />
const inputs = await testUtils.queries.waitForQueryAllByPlaceholder('async-placeholder')
按照属性查询
queryByAttribute
function queryByAttribute(attr: string, value: any): HTMLElement
参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
attr | string | 是 | 属性 key |
value | any | 是 | 属性 value |
用法:
// <div key="value" />
const view = testUtils.queries.queryByAttribute('key', 'value')
queryAllByAttribute
function queryAllByAttribute(attr: string, value: any): HTMLElement[]
参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
attr | string | 是 | 属性 key |
value | any | 是 | 属性 value |
用法:
// <div key="value" />
// <div key="value" />
const view = testUtils.queries.queryAllByAttribute('key', 'value')
waitForQueryByAttribute
async function waitForQueryByAttribute(attr: string, value: string, params?: TParams): Promise<HTMLElement>
参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
attr | string | 是 | 属性 key |
value | any | 是 | 属性 value |
params | TWaitforParams | 参数:见 TWaitforParams 说明 |
用法:
// <div key="value" />
const view = await testUtils.queries.waitForQueryByAttribute('key', 'value')
waitForQueryAllByAttribute
async function waitForQueryAllByAttribute(attr: string, value: string, params?: TParams): Promise<HTMLElement[]>
参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
attr | string | 是 | 属性 key |
value | any | 是 | 属性 value |
params | TWaitforParams | 参数:见 TWaitforParams 说明 |
用法:
// <div key="value" />
// <div key="value" />
const inputs = await testUtils.queries.waitForQueryAllByAttribute('key', 'value')