React Native中如何检测数据是否为key-value格式

RN 运行在 JS 引擎环境，日常业务里说的 key-value 格式，本质指的是纯普通对象（Plain Object）——也就是以字符串/Symbol 为键、值为任意合法类型的无序键值对集合，需要和数组、特殊内置对象、类实例做明确区分。

核心判断思路 #

按优先级逐层过滤不符合要求的类型：

• 先筛掉所有基础类型、null：这类值根本不是对象结构，直接判定不符合
• 筛掉数组：数组是索引有序集合，不属于常规 key-value 结构
• 筛掉特殊对象：包括 Map、Set、Date、RegExp、Error、RN 原生模块实例、自定义类实例等，这类对象的原型链不直接指向 Object.prototype，不属于纯键值对结构
• 按需加自定义校验：如果业务要求 key 不能是 Symbol、不允许空对象、值有固定类型要求，在基础判断通过后追加校验逻辑即可

可直接复用的实现代码 #

1. 检测 JS 运行时对象 #

const isKeyValueFormat = (data) => {
  // 过滤基础类型、null
  if (typeof data !== 'object' || data === null) return false;
  // 过滤数组
  if (Array.isArray(data)) return false;
  // 过滤非纯Object的特殊对象、类实例
  const proto = Object.getPrototypeOf(data);
  if (proto !== null && proto !== Object.prototype) return false;

  // 可选：如果业务不允许Symbol作为key，放开下方注释
  // const symbolKeys = Object.getOwnPropertySymbols(data);
  // if (symbolKeys.length > 0) return false;

  // 可选：如果业务不允许空对象，放开下方注释
  // if (Object.keys(data).length === 0) return false;

  return true;
};

2. 检测JSON序列化后的key-value字符串 #

如果待检测数据是接口返回、本地存储读取的JSON字符串，先做解析容错再判断：

const isKeyValueStr = (source) => {
  if (typeof source !== 'string') return false;
  try {
    const parsedData = JSON.parse(source);
    return isKeyValueFormat(parsedData);
  } catch (e) {
    // JSON格式非法直接判定不符合
    return false;
  }
};

RN场景特殊注意点 #

• 不要用typeof x === 'object'直接判断：这个逻辑会把null、数组、原生桥接对象、XHR实例等都误判为符合要求
• 不要用x instanceof Object判断：数组、Date、自定义类实例都会通过这个校验，误判率极高
• 原生端桥接传递的NSDictionary（iOS）、HashMap（Android）到RN层后会自动转为普通JS对象，上述判断函数可以正常识别
• 如果业务里把Map也算作合法key-value结构，只需要在判断逻辑里追加data instanceof Map的放行分支即可，按需调整

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