查询相关 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')