getCacheElement - Supernote

该接口会根据元素 uuid 获取缓存的 Element 数据（包含笔划、链接、标题、几何图形与文本框等）。典型用途：只保存了某个元素的 uuid（例如上一次 createElement/getElements 拿到后又释放了完整对象），后续需要时可以用它重新取回缓存中的 Element 数据，而不用重新查一遍整页。

调用 clearElementCache() 清空缓存后，旧的 Element 对象/uuid 将无法再用于读取缓存数据。

static getCacheElement(uuid: string): Promise<APIResponse<Element>>;

参数

参数	类型	说明
`uuid`	`string`	元素 UUID

APIResponse<Element>：result 为 Element（未命中缓存时 result 可能为空）

示例

import { PluginCommAPI } from 'sn-plugin-lib';

/**
 * 根据 uuid 获取缓存 Element 的示例。
 */
export async function exampleGetCacheElement(uuid: string) {
  const res = (await PluginCommAPI.getCacheElement(uuid)) as any;
  if (!res.success) {
    console.log('getCacheElement failed', res.error);
    throw new Error(res.error?.message ?? 'getCacheElement 调用失败');
  }
  console.log('getCacheElement result', res.result);
  return res.result;
}

​示例

示例