clipboard.readImage()

读取系统剪贴板中的静态栅格图像，并写入 ByteSink。宿主重新嗅探 MIME 和校验解码预算。

Syntax

const image = await host.clipboard.readImage(output);

Return value

{ mime, written, required? } | null

Examples

const output = new Uint8Array(16 * 1024 * 1024);
const image = await host.clipboard.readImage(output);
if (image) editor.insertImage(output.subarray(0, image.written), image.mime);

Errors

activation-required、unsupported-format、sink-too-small、invalid-data、limit-exceeded。

Requirements

• 能力：host:clipboard.readImage
• 每次可信用户激活：必须
• 信任档位：lime

See also

clipboard.writeImage()、asset.read()