Hello HTML
')\nconsole.log(getClipboardHtml())\n\n// 获取完整剪贴板数据\nconst data = getFullClipboardData()\nconsole.log('可用格式:', data.availableFormats)\nconsole.log('文本内容:', data.text)\nconsole.log('HTML内容:', data.html)\n\n// 清空剪贴板\nclearClipboard()\n```\n\n## 图片操作\n\n### 基本图片操作\n\n```javascript\nconst { ClipboardManager, getClipboardImageData } = require('@teddyzhu/clipboard')\nconst fs = require('fs')\n\nconst clipboard = new ClipboardManager()\n\n// 检查是否有图片\nif (clipboard.hasFormat('image')) {\n // 获取图片详细信息\n const imageData = clipboard.getImageData()\n console.log('图片宽度:', imageData.width + 'px')\n console.log('图片高度:', imageData.height + 'px')\n console.log('图片大小:', imageData.size + ' bytes')\n\n // 保存图片到文件\n fs.writeFileSync('clipboard_image.png', imageData.data)\n\n // 获取 base64 编码\n const base64 = clipboard.getImageBase64()\n console.log('Base64 长度:', base64.length)\n}\n\n// 从文件设置图片\nconst imageBuffer = fs.readFileSync('image.png')\nclipboard.setImageRaw(imageBuffer)\n\n// 从 base64 设置图片\nconst base64Data = fs.readFileSync('image.png', 'base64')\nclipboard.setImageBase64(base64Data)\n\n// 快速图片操作\nconst quickImageData = getClipboardImageData()\n```\n\n### 异步图片操作\n\n```javascript\nconst clipboard = new ClipboardManager()\n\n// 异步获取图片\ntry {\n const imageData = await clipboard.getImageDataAsync()\n console.log('异步获取图片:', imageData.width + 'x' + imageData.height)\n\n const base64 = await clipboard.getImageBase64Async()\n console.log('异步获取 Base64 长度:', base64.length)\n} catch (error) {\n console.error('获取图片失败:', error.message)\n}\n\n// 异步文本操作\nawait clipboard.setTextAsync('Hello Async!')\nconst text = await clipboard.getTextAsync()\nconsole.log('异步文本:', text)\n```\n\n## 文件操作\n\n```javascript\nconst { ClipboardManager, getClipboardFiles, setClipboardFiles } = require('@teddyzhu/clipboard')\n\nconst clipboard = new ClipboardManager()\n\n// 设置文件列表\nconst files = ['/path/to/file1.txt', '/path/to/file2.pdf']\nclipboard.setFiles(files)\n\n// 获取文件列表\nif (clipboard.hasFormat('files')) {\n const clipboardFiles = clipboard.getFiles()\n console.log('剪贴板中的文件:', clipboardFiles)\n}\n\n// 快速文件操作\nsetClipboardFiles(['/path/to/document.pdf'])\nconst quickFiles = getClipboardFiles()\nconsole.log('快速获取文件:', quickFiles)\n```\n\n## 自定义格式数据\n\n```javascript\nconst clipboard = new ClipboardManager()\n\n// 设置自定义格式数据\nconst customData = Buffer.from('custom binary data')\nclipboard.setBuffer('application/custom', customData)\n\n// 获取自定义格式数据\ntry {\n const data = clipboard.getBuffer('application/custom')\n console.log('自定义数据:', data.toString())\n} catch (error) {\n console.error('自定义格式不存在')\n}\n```\n\n## 复合内容操作\n\n```javascript\nconst { ClipboardManager, setClipboardContents } = require('@teddyzhu/clipboard')\n\nconst clipboard = new ClipboardManager()\n\n// 同时设置多种格式\nconst contents = {\n text: 'Hello World!',\n html: 'Multi-format content
',\n})\n```\n\n## 剪贴板监听\n\n### 基本监听\n\n```javascript\nconst { ClipboardListener } = require('@teddyzhu/clipboard')\n\nconst listener = new ClipboardListener()\n\nlistener.watch((data) => {\n console.log('剪贴板数据变化:', data)\n console.log('可用格式:', data.availableFormats)\n\n if (data.text) {\n console.log('文本:', data.text)\n }\n\n if (data.html) {\n console.log('HTML:', data.html)\n }\n\n if (data.rtf) {\n console.log('RTF:', data.rtf)\n }\n\n if (data.image) {\n console.log('图片信息:')\n console.log(' 尺寸:', data.image.width + 'x' + data.image.height + 'px')\n console.log(' 大小:', data.image.size + ' bytes')\n // 注意：图片数据在 data.image.data (Buffer) 中，不是 base64Data\n console.log(' 数据类型:', Buffer.isBuffer(data.image.data) ? 'Buffer' : typeof data.image.data)\n }\n\n if (data.files) {\n console.log('文件:', data.files)\n }\n})\n\n// 检查监听状态\nconsole.log('是否正在监听:', listener.isWatching())\nconsole.log('监听器类型:', listener.getListenerType()) // 'wayland' 或 'generic'\n\n// 停止监听\nsetTimeout(() => {\n listener.stop()\n console.log('已停止监听')\n}, 10000)\n```\n\n## Wayland 支持\n\n本库对 Linux Wayland 环境提供原生支持：\n\n```javascript\nconst { isWaylandClipboardAvailable, ClipboardListener } = require('@teddyzhu/clipboard')\n\n// 检查 Wayland 剪贴板是否可用\nif (isWaylandClipboardAvailable()) {\n console.log('Wayland 剪贴板监听可用')\n\n const listener = new ClipboardListener()\n console.log('当前监听器类型:', listener.getListenerType()) // 在 Wayland 下会显示 'wayland'\n\n // Wayland 监听器会自动处理不同的 MIME 类型\n listener.watch((data) => {\n console.log('Wayland 剪贴板变化:', data)\n })\n} else {\n console.log('使用通用剪贴板监听器')\n}\n```\n\n## API 参考\n\n### ClipboardManager 类\n\n| 方法 | 描述 |\n| ---------------------------- | -------------------------------------- |\n| `getText()` | 获取纯文本内容 |\n| `setText(text)` | 设置纯文本内容 |\n| `getHtml()` | 获取 HTML 内容 |\n| `setHtml(html)` | 设置 HTML 内容 |\n| `getRichText()` | 获取 RTF 富文本内容 |\n| `setRichText(text)` | 设置 RTF 富文本内容 |\n| `getImageBase64()` | 获取图片的 base64 编码 |\n| `getImageData()` | 获取图片详细信息（包含尺寸和原始数据） |\n| `setImageBase64(base64Data)` | 从 base64 设置图片 |\n| `setImageRaw(buffer)` | 从 Buffer 设置图片 |\n| `getImageRaw()` | 获取图片原始数据（Buffer） |\n| `getFiles()` | 获取文件列表 |\n| `setFiles(files)` | 设置文件列表 |\n| `setBuffer(format, buffer)` | 设置自定义格式数据 |\n| `getBuffer(format)` | 获取自定义格式数据 |\n| `setContents(contents)` | 设置复合内容 |\n| `hasFormat(format)` | 检查是否包含指定格式 |\n| `getAvailableFormats()` | 获取所有可用格式 |\n| `clear()` | 清空剪贴板 |\n\n### 异步方法\n\n| 方法 | 描述 |\n| ----------------------- | -------------------- |\n| `getTextAsync()` | 异步获取文本内容 |\n| `setTextAsync(text)` | 异步设置文本内容 |\n| `getImageBase64Async()` | 异步获取图片 base64 |\n| `getImageDataAsync()` | 异步获取图片详细信息 |\n\n### ClipboardListener 类\n\n| 方法 | 描述 |\n| ------------------- | ---------------------------------------- |\n| `watch(callback)` | 开始监听剪贴板变化 |\n| `stop()` | 停止监听 |\n| `isWatching()` | 检查是否正在监听 |\n| `getListenerType()` | 获取监听器类型（'wayland' 或 'generic'） |\n\n### 快速操作函数\n\n| 函数 | 描述 |\n| ------------------------------------ | --------------------------- |\n| `getClipboardText()` | 快速获取文本 |\n| `setClipboardText(text)` | 快速设置文本 |\n| `getClipboardHtml()` | 快速获取 HTML |\n| `setClipboardHtml(html)` | 快速设置 HTML |\n| `getClipboardImage()` | 快速获取图片（base64） |\n| `getClipboardImageData()` | 快速获取图片详细信息 |\n| `setClipboardImage(base64Data)` | 快速设置图片（base64） |\n| `setClipboardImageRaw(buffer)` | 快速设置图片（Buffer） |\n| `getClipboardImageRaw()` | 快速获取图片原始数据 |\n| `getClipboardFiles()` | 快速获取文件列表 |\n| `setClipboardFiles(files)` | 快速设置文件列表 |\n| `getClipboardBuffer(format)` | 快速获取自定义格式数据 |\n| `setClipboardBuffer(format, buffer)` | 快速设置自定义格式数据 |\n| `setClipboardContents(contents)` | 快速设置复合内容 |\n| `getFullClipboardData()` | 快速获取完整剪贴板数据 |\n| `clearClipboard()` | 快速清空剪贴板 |\n| `isWaylandClipboardAvailable()` | 检查 Wayland 剪贴板是否可用 |\n\n## 数据结构\n\n### ClipboardData\n\n```typescript\ninterface ClipboardData {\n availableFormats: string[] // 可用的格式列表\n text?: string // 纯文本内容\n rtf?: string // RTF 富文本内容\n html?: string // HTML 内容\n image?: ImageData // 图片数据\n files?: string[] // 文件列表\n}\n```\n\n### ImageData\n\n```typescript\ninterface ImageData {\n width: number // 图片宽度（像素）\n height: number // 图片高度（像素）\n size: number // 图片数据大小（字节）\n data: Buffer // 图片原始数据（Buffer）\n}\n```\n\n## 注意事项\n\n1. **图片格式**：所有图片都会转换为 PNG 格式存储\n2. **文件路径**：文件路径需要是绝对路径\n3. **自定义格式**：自定义格式的 MIME 类型需要遵循标准\n4. **Wayland 支持**：在 Wayland 环境下会自动使用专用监听器以获得更好的性能\n5. **异步操作**：对于可能耗时的操作，推荐使用异步版本\n6. **错误处理**：所有方法都可能抛出异常，请适当处理错误\n\n## 许可证\n\nMIT","users":{}}