`table.checkStatus is not a function` 或 `checkStatus.d 为 undefined`

Question

在使用 Layui 框架进行表格（table）开发时，常遇到 `table.checkStatus is not a function` 或 `checkStatus.d 为 undefined` 的报错。该问题多发生于：① 未正确引入或加载 `layui.table` 模块（如漏写 `layui.use(['table'], callback)`）；② 在 `table.render()` 渲染完成前调用 `table.checkStatus('id')`，导致实例尚未注册；③ 表格 ID 不匹配（传入的 `id` 与 `render()` 中设置的 `id` 属性不一致）；④ 使用了低版本 Layui（< 2.5.0），而 `checkStatus` 方法在 2.5.0+ 才正式支持。值得注意的是，`checkStatus.d` 是内部状态对象，若为 `undefined`，往往意味着对应表格实例根本未成功初始化。排查时应优先检查模块加载顺序、渲染时机及 ID 唯一性，避免在 DOM 就绪但表格未 render 完成时执行状态查询。

Answer 1

```html

一、现象层：错误表征与典型堆栈

开发者在控制台最常看到两类报错：

• TypeError: table.checkStatus is not a function
• Cannot read property 'd' of undefined（源于 table.checkStatus('demo').d）

二者本质同源：调用方试图访问一个尚未就绪或根本不存在的表格实例状态对象。该错误不抛出具体行号，却高频阻断“全选/反选”“批量操作”等核心交互逻辑。

二、模块层：依赖加载与执行上下文

Layui 是模块化设计，table 并非全局可用——必须显式声明依赖：

layui.use(['table', 'jquery'], function() {
  var table = layui.table;
  // ✅ 此处 table 才具备 checkStatus 方法
});

若遗漏 layui.use 或未将 'table' 列入数组，则 table 为未定义对象，其方法自然不可调用。更隐蔽的是：在 $(document).ready() 中直接调用 table.checkStatus，此时 Layui 模块尚未初始化，等价于在 Node.js 中未 require('fs') 就调 fs.readFileSync。

三、生命周期层：渲染完成才是实例注册的充要条件

关键认知：table.render() 是异步注册行为。其返回值仅为配置对象，不表示 DOM 渲染完毕，更不保证实例已注入内部 registry。

graph LR
A[调用 table.render config] --> B[创建 table 实例]
B --> C[注入 layui.table.indexMap]
C --> D[DOM 插入 & 事件绑定]
D --> E[实例可被 checkStatus 访问]

四、标识层：ID 唯一性与作用域穿透

表格 ID 是实例的唯一键（key），需严格满足：

场景	正确写法	错误示例
render 配置	id: 'userTable'	id: 'user-table'
checkStatus 调用	table.checkStatus('userTable')	table.checkStatus('usertable')（大小写敏感）

五、版本层：API 演进与兼容性断点

checkStatus 方法自 Layui v2.5.0 起正式引入（commit 4a8c1b7），此前版本仅支持 table.cache['id'] 手动遍历。验证方式：

console.log(layui.v); // 输出如 "2.8.18"
console.log(typeof table.checkStatus); // "function" or "undefined"

低版本强行调用将静默失败；升级后仍报错？说明模块未重载或 CDN 缓存未清除——需强制刷新 Ctrl+F5 并检查 Network 面板中 layui.js 实际加载版本。

六、诊断层：四步精准定位法

1. ✅ 检查 layui.use(['table'], ...) 是否包裹所有 table 相关代码
2. ✅ 在 table.render() 的 done 回调内首次调用 checkStatus
3. ✅ 对比 render.id 与 checkStatus(id) 字符串完全一致（含空格、连字符）
4. ✅ 运行 console.log(layui.table.indexMap)，确认目标 ID 已作为 key 存在

七、工程层：防御性封装与最佳实践

推荐封装安全调用函数，规避时序风险：

function safeCheckStatus(tableId, timeout = 3000) {
  const start = Date.now();
  return new Promise((resolve, reject) => {
    const tryGet = () => {
      const status = layui.table.checkStatus(tableId);
      if (status && status.data !== undefined) {
        resolve(status);
      } else if (Date.now() - start > timeout) {
        reject(new Error(`Table ${tableId} instance not registered within ${timeout}ms`));
      } else {
        setTimeout(tryGet, 50);
      }
    };
    tryGet();
  });
}

// 使用
safeCheckStatus('userTable').then(res => console.log(res.data));

```