Typescript环境下使用WebDriver.IO调用browser.setValue()报TypeError

• 版本API变更导致的方法归属调整
  不少用户查阅官方文档时，没有注意到setValue是Element类下的成员方法，而非Browser全局类的方法。WebdriverIO从v6版本开始，将setValue方法从全局browser实例上移到了元素实例的方法集里，不再支持直接传入选择器、通过browser全局调用setValue的旧写法。如果照搬v5版本的老测试代码，就会触发browser.setValue is not a function的报错。
  正确的调用逻辑是先通过$(选择器)方法定位到对应的页面对象，再在元素实例上调用setValue，修正后的测试代码如下：

  it('should let you log in', () => {
      browser.url('https://www.some-website.com/');
      const emailInput = $('input[name="email"]');
      emailInput.setValue('some.email@domain.com');
      emailInput.keys('\uE007'); 
  
      const pwdInput = $('input[name="password"]');
      pwdInput.setValue('password!');
      pwdInput.keys('\uE007'); 
  });
  

• 运行时实例未正确绑定
  如果已经按照元素实例的方式调用还是报方法不存在，需要检查两个配置项：
  • 确认测试用例是通过wdio官方测试运行器（runner）启动执行的，不是脱离runner直接用ts-node、jasmine等工具单独跑测试脚本。全局的browser实例、以及对应元素API的绑定逻辑，都是wdio runner在启动测试时动态注入到测试上下文的，脱离runner环境根本不会挂载这些封装方法。
  • 确认没有在项目代码中手动引入原始的Webdriver核心客户端，替代了runner注入的全局browser实例——原生的Webdriver客户端只提供最底层的协议调用能力，不带setValue、keys这类高层封装方法。
• TS类型配置偏差
  如果TS编译阶段就提示找不到setValue方法，需要检查tsconfig.json的types配置项，确保明确引入了@wdio/globals/types的类型声明。如果类型声明加载不全，会导致TS解析的时候把browser实例识别为没有对应方法的对象类型，连带运行时的全局路径解析也可能出现偏差，拿不到挂载完整方法的browser实例。

额外优化提示：在表单交互场景下，不需要手动调用回车键提交，元素实例的setValue执行完成后，直接配合browser.submitForm()方法即可完成提交，代码可读性会更高。

内容的提问来源于stack exchange，提问作者mchd