Function getData

ui/src/protocol/path-resolver.ts:183–229

(data: DataValue, path: string)

 * @returns 路径对应的数据值，如果路径不存在则返回 null
 */
export function getData(data: DataValue, path: string): DataValue | null {
  // 验证路径
  if (!isValidJsonPointer(path)) {
    return null;
  }

  // 空路径返回整个数据
  if (path === '') {
    return data;
  }

  // 解析路径
  const tokens = parseJsonPointer(path);

  // 遍历路径
  let current: DataValue | undefined = data;

  for (const token of tokens) {
    if (current === null || current === undefined) {
      return null;
    }

    // 处理数组
    if (Array.isArray(current)) {
      // 检查是否为有效的数组索引
      const index = parseInt(token, 10);
      if (isNaN(index) || index < 0 || index >= current.length) {
        return null;
      }
      current = current[index] as DataValue | undefined;
    }
    // 处理对象
    else if (typeof current === 'object') {
      const obj = current as DataMap;
      if (!(token in obj)) {
        return null;
      }
      current = obj[token];
    }
    // 基本类型无法继续遍历
    else {
      return null;
    }
  }

  return current ?? null;
}

/**
 * 在数据模型中设置指定路径的数据