app.trash - 废纸篓 API

将文件移至废纸篓。

方法

app.trash.moveToTrash(path)

将文件或目录移至废纸篓。

参数:

  • path (string|array) - 文件路径或路径数组

返回值:

  • 单文件: string, error - 废纸篓中的路径
  • 多文件: array<string>, error - 废纸篓路径数组
-- 移动单个文件
local trashPath, err = app.trash.moveToTrash("/path/to/file.txt")
if trashPath then
    app.log.info("已移至: " .. trashPath)
end

-- 移动多个文件
local paths, err = app.trash.moveToTrash({
    "/path/to/file1.txt",
    "/path/to/file2.txt"
})

示例

安全删除选中文件

function MyPlugin:handleTrash(context)
    local count = #context.selectedFiles
    if not app.dialog.confirm("确定要将 " .. count .. " 个文件移至废纸篓?") then
        return
    end

    local paths, err = app.trash.moveToTrash(context.selectedFiles)
    if paths then
        app.notification.show("完成", "已移至废纸篓: " .. #paths .. " 个文件")
    else
        app.dialog.alert("错误", err or "操作失败")
    end
end
开发者文档
使用帮助
使用说明 脚本菜单 常见问题
脚本开发
开发指南
插件开发
快速开始 开发指南 示例插件
API 参考
概览 API 查询 插件信息 日志 Finder 上下文 插件设置 国际化
UI 与交互
对话框 进度条 系统通知 选择器 WebView 状态栏 Dock
文件与路径
文件操作 路径工具 Finder 操作 废纸篓 扩展属性 元数据 文件监听
数据格式
JSON Plist CSV XML PDF 图片
文本与编码
字符串 正则表达式 日期时间 颜色 加密编码
系统
Shell 命令 进程管理 应用管理 系统信息 AppleScript 快捷指令
系统信息
网络信息 电源/电池 屏幕/外观 音频控制 蓝牙设备 位置服务
网络
HTTP 请求 WebSocket URL 工具
输入与剪贴板
键盘模拟 鼠标模拟 全局热键 剪贴板 窗口管理
存储
SQLite Keychain UserDefaults
媒体
文字识别 二维码
工具
归档 类型标识 分享 定时器 防休眠 并发/协程