Tauri ShellAllowlistConfig

2024-01-30 14:50 更新

shell API 的允许列表。

类型:​object

名字类型违约描述
scope
ShellAllowlistScope[]二进制执行 API 的访问范围。Sidecar 会自动启用。
all
booleanfalse使用此标志可启用所有 shell API 功能。
execute
booleanfalse启用二进制执行。
sidecar
booleanfalse启用 sidecar 执行,允许 JavaScript 层生成 sidecar 命令,这是应用程序附带的可执行文件。有关详细信息,请参阅 https://tauri.app/v1/guides/building/sidecar
open
ShellAllowlistOpenfalse使用用户的默认应用程序打开 URL。

ShellAllowlistScope

Shell 范围定义。它是命令名称和关联的 CLI 参数的列表,用于限制从 Web 视图访问 API。

类型:​ShellAllowedCommand[]

ShellAllowedCommand

允许由 webview API 执行的命令。

类型:​object

名字类型违约描述
name
string(必填)此允许的 shell 命令配置的名称。

此名称将在 webview API 内部用于调用此命令以及任何指定的参数。
cmd
string命令名称。它可以从解析为系统基目录的变量开始。变量为:、、、$AUDIO$CACHE$CONFIG$DATA$LOCALDATA$DESKTOP$DOCUMENT$DOWNLOAD$EXE$FONT$HOME$PICTURE$PUBLIC$RUNTIME$TEMPLATE$VIDEO$RESOURCE$APP$LOG$TEMP$APPCONFIG$APPDATA$APPLOCALDATA$APPCACHE$APPLOG
args
ShellAllowedArgsfalse命令执行允许的参数。
sidecar
booleanfalse如果此命令是 sidecar 命令。

ShellAllowedArgs

允许 webview API 执行的一组命令参数。

值 将允许将任何参数传递给命令。 将禁用所有参数。[] 列表会将这些参数设置为要传递给附加命令配置的唯一有效参数。​true​false​ShellAllowedArg

可以是以下任何一种类型:

  • boolean​:使用简单的布尔值允许或禁用此命令配置的所有参数。
  • ShellAllowedArg[]​:一组特定的 [],可用于调用命令配置。​ShellAllowedArg

ShellAllowedArg

允许由 webview API 执行的命令参数。

可以是以下任何一种类型:

  • string​:一个不可配置的参数,按指定的顺序传递给命令。
  • object​:从 webview API 调用命令时设置的变量。

ShellAllowlistOpen

定义 API 范围。​shell > open

可以是以下任何一种类型:

  • boolean​:是否应启用 shell open API。如果启用,则使用默认验证正则表达式 ()。​^((mailto:\w+)|(tel:\w+)|(https?://\w+)).+
  • string​:启用 shell open API,其中包含打开的路径必须与之匹配的自定义正则表达式。如果使用自定义正则表达式来支持非 http(s) 架构,则应注意防止允许类似标志的字符串通过验证的值。例如 , , .​--enable-debugging-i/R


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号