Loongship Data

Appearance

Mock 模式 ​

如果你正在做页面演示或前端联调，可以开启 mock 模式。SDK 会直接返回一份类型正确的随机示例数据，而不会发送真实 HTTP 请求。

基础用法 ​

为单次请求开启 ​

typescript
const response = await client.ship.search(
  { kw: 'COSCO' },
  { mock: true }
);

console.log(response.data);

为整个 client 开启默认 mock ​

typescript
const client = lsData.create({
  mock: true
});

const response = await client.ship.search({ kw: 'COSCO' });

与 raw 一起使用 ​

你也可以把 mock 和 raw: true 一起打开，用来查看生成后的原始 mock 载荷：

typescript
const response = await client.weather.current(
  { lon: 121000000, lat: 31000000 },
  { mock: true, raw: true }
);

console.log(response.raw);

行为说明 ​

  • request options.mock 优先级高于 client mock
  • 你可以用 lsData.create({ mock: true }) 为整个 client 开启默认 mock
  • 也可以在单次请求里传 { mock: false } 临时关闭
  • 返回值会尽量贴近当前类型定义，但不保证真实业务语义。
  • 数据是随机生成的，不保证稳定或可复现。
  • signal 仍然有效。
  • timeout 会被忽略，因为没有真实网络请求。