在WebdriverIO的TypeScript测试中，浏览器元素应使用什么类型？

数据老陈

2026-7-6

WebdriverIO 元素类型指定解决方案

问题分析

你尝试使用的ChainablePromiseElement<Promise<Element>>是旧版WebdriverIO的类型写法，当前版本中ChainablePromiseElement的泛型参数应为Element而非Promise<Element>，且未正确导入类型也会触发“Type 'ChainablePromiseElement' is not generic”错误。

具体解决方案

场景1：传入已await的元素

如果你的login_input是通过await $('div.login_input')解析后的元素，直接指定类型为Element即可：

import { Element } from 'webdriverio';

const login_input = await $('div.login_input');
await set_login('login', login_input);

const set_login = async (
  login: string, 
  login_input: Element
): Promise<void> => {
  await login_input.setValue(login);
};

场景2：传入未await的链式元素

如果login_input是$()返回的未await结果（链式Promise对象），使用ChainablePromiseElement<Element>类型：

import { ChainablePromiseElement, Element } from 'webdriverio';

const login_input = $('div.login_input');
await set_login('login', login_input);

const set_login = async (
  login: string, 
  login_input: ChainablePromiseElement<Element>
): Promise<void> => {
  await login_input.setValue(login);
};

场景3：兼容版本的自动推导写法

为避免版本更新导致类型失效，用ReturnType和Awaited自动推导元素类型：

const login_input = await $('div.login_input');
await set_login('login', login_input);

const set_login = async (
  login: string, 
  login_input: Awaited<ReturnType<typeof $>>
): Promise<void> => {
  await login_input.setValue(login);
};