Detox 18.22.1调用web()报detox_1.web is not a function如何解决

错误根因 #

你当前使用的Detox 18.22.1版本未提供web()导出API，该方法是Detox 19.0.0及以上版本才新增的webview专属构造方法，你参考的类型示例属于更高版本的Detox代码，版本不匹配直接导致运行时报web is not a function错误。

排查与修复步骤 #

• 首先确认本地实际安装的Detox版本，执行以下命令验证：

  npm list detox
  # 用yarn的话执行 yarn list detox
  

  确认返回版本为18.x系列即可确定是版本不匹配问题。
• 可选修复方案：
  1. 升级Detox到19.0.0及以上版本
     升级前核对版本迁移说明调整不兼容的配置项，升级完成后你现有导入web、调用web(by.id('Web View'))的代码可正常运行，不需要额外修改逻辑。
  2. 保留18.x版本，替换为对应版本支持的webview操作语法
     18.x版本不需要用web()构造方法，直接用原生元素定位语法即可操作webview：

  // 直接定位webview元素，不需要调用web()
  private webView: Detox.Element;
  // 构造函数中赋值
  this.webView = element(by.id('Web View'));
  

  后续操作webview内部元素时，使用18.x版本支持的by.web.xxx选择器即可完成交互。
• 额外校验TS类型配置：如果你安装了独立的@types/detox类型包，需要将类型包版本也和当前安装的Detox运行时版本对齐，避免出现类型声明和实际可用API不一致的问题。

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