JavaScript 中怎么 Mock 地理定位 Geolocation API-js教程-PHP中文网

javascript测试中mock geolocation api的核心是替换全局navigator.geolocation对象行为，通过手动覆盖或jest mock方式控制getcurrentposition返回假坐标或错误，需注意只读属性处理、错误码模拟及测试后清理。

javascript 中怎么 mock 地理定位 geolocation api

在 JavaScript 测试中 Mock Geolocation API，核心是**替换全局 navigator.geolocation 对象的行为**，使其返回可控的坐标或模拟错误，避免真实调用浏览器定位接口。常用方式有手动 mock 和借助测试框架（如 Jest）的自动 mock。

手动覆盖 navigator.geolocation

适用于简单场景或非 Jest 环境（如 Mocha + Sinon，或纯浏览器测试）。关键点是提前在测试前重写 getCurrentPosition 和可选的 watchPosition 方法：

用 Object.defineProperty 或直接赋值确保覆盖成功（注意部分环境 navigator.geolocation 是只读属性，需先用 delete 或 writable: true 处理）
getCurrentPosition 接收 success 回调和 error 回调，按需触发其一
返回假的 position 对象，包含 coords（含 latitude、longitude 等）和 timestamp

示例：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

// 测试前执行
delete navigator.geolocation;
navigator.geolocation = {
  getCurrentPosition: jest.fn((success, error) => {
    success({
      coords: { latitude: 39.9042, longitude: 116.4074 },
      timestamp: Date.now()
    });
  }),
  watchPosition: jest.fn()
};

Jest 中自动 mock Geolocation

Jest 提供更简洁的 mock 方式，推荐在 Jest 环境中使用：

在测试文件顶部或 setupFilesAfterEnv 中定义 mock
用 jest.mock 不适用（因为 navigator 是全局对象，不是模块），应直接修改 global.navigator
配合 beforeEach 重置 mock 调用记录，保证测试隔离

示例：

beforeEach(() => {
  Object.defineProperty(navigator, 'geolocation', {
    value: {
      getCurrentPosition: jest.fn(),
      watchPosition: jest.fn()
    },
    writable: true
  });
});

test('calls success callback with Beijing coords', () => {
  const success = jest.fn();
  const error = jest.fn();

  // 模拟成功响应
  navigator.geolocation.getCurrentPosition.mockImplementation((cb) => {
    cb({ coords: { latitude: 39.9042, longitude: 116.4074 }, timestamp: Date.now() });
  });

  myLocationFunction(); // 触发定位逻辑
  expect(navigator.geolocation.getCurrentPosition).toHaveBeenCalledTimes(1);
  expect(success).toHaveBeenCalledWith(
    expect.objectContaining({ coords: expect.objectContaining({ latitude: 39.9042 }) })
  );
});

模拟定位失败场景

真实应用需处理用户拒绝授权、设备无 GPS、超时等错误。Mock 时主动调用 error 回调，并传入标准 PositionError 对象：

code：1（PERMISSION_DENIED）、2（POSITION_UNAVAILABLE）、3（TIMEOUT）
message：可选描述性文本
确保业务代码能正确识别并响应不同错误码

示例：

navigator.geolocation.getCurrentPosition.mockImplementation((_, errorCb) => {
  errorCb({
    code: 1,
    message: 'User denied geolocation prompt'
  });
});

注意兼容性与清理

某些测试运行器（如 jsdom）默认不提供 navigator.geolocation，需手动补全；而真实浏览器中该对象存在但不可写，需用 Object.defineProperty 强制可写。测试结束后建议还原原始行为（尤其在全局 setup 中），避免影响其他测试：

保存原始引用，测试后恢复：const original = navigator.geolocation; → navigator.geolocation = original;
Jest 中可用 afterEach(() => { jest.clearAllMocks(); }); 清理 mock 调用记录
若用 Object.defineProperty 修改了 writable 属性，记得恢复原 descriptor

不复杂但容易忽略。