webbrowser

Rust 库，用于在平台上的网络浏览器中打开 URL 和本地文件，保证 一致性行为。

灵感来自 webbrowser Python 库

文档

• API 参考
• 发行说明

示例

use webbrowser;

if webbrowser::open("http://github.com").is_ok() {
    // ...
}

平台支持

一致性行为

webbrowser 在所有平台上定义了一致的行为，如下所示

• 浏览器保证 - 该库保证打开浏览器，即使是本地文件 - 在撰写本文时，这是唯一做出此类保证的 crate。其他库依赖于现有的系统命令，这可能导致编辑器被打开（而不是浏览器）来打开本地 html 文件，从而导致用户的不一致行为。
• 非阻塞 对于基于 GUI 的浏览器（例如 Firefox、Chrome 等），而对于基于文本的浏览器（例如 lynx 等）是 阻塞 的
• 抑制输出 默认情况下用于基于 GUI 的浏览器，因此它们的 stdout/stderr 不会污染主程序输出。这可以通过 webbrowser::open_browser_with_options 覆盖。

crate 功能

webbrowser 可选地允许配置以下功能

• hardened - 这将禁用非 http(s) url 的处理（例如 file:///），作为一项硬安全预防措施
• disable-wsl - 这将禁用 WSL file 实现（http 仍然有效）
• wasm-console - 这将启用向 wasm 控制台记录日志（仅在 wasm 平台上有效）

想要贡献吗？

欢迎提交

• 错误
• 支持任何平台上非默认的浏览器调用

重要提示（在测试期间）

• 此库在运行时需要浏览器和图形环境的可用性
• cargo test 实际上会在本地打开浏览器

在贡献时，请注意您的作品将按照以下方式双授权为 MIT + Apache-2.0（见下文）。

许可证

SPDX-许可证-标识符:Apache-2.0 或 MIT

许可在以下两者之一下

• Apache 许可证第 2 版，（LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0）
• MIT 许可证（LICENSE-MIT 或 http://opensource.org/licenses/MIT）

您可选择。

贡献

除非您明确声明，否则您有意提交以包含在您的工作中的任何贡献，如 Apache-2.0 许可证中定义，将按上述方式双授权，不附加任何其他条款或条件。