Quarto中webr结合gt包报错：'browser'必须为非空字符串求助

问题背景 #

在Quarto中使用webr工具运行{ggplot2}时一切正常，但切换到{gt}包时，即便YAML中已配置加载{gt}，运行表格生成代码却抛出错误：Error: 'browser' must be a non-empty character string。虽然?gt能调出帮助文档说明包已加载，但缺少相关适配指引。

原因分析 #

{gt}包默认在生成表格后会尝试调用系统浏览器进行预览，但webr是运行在浏览器环境中的WebAssembly版本R，没有可用的系统级浏览器上下文，因此触发了该错误。

解决方案 #

需要让{gt}生成可直接嵌入Quarto文档的HTML内容，而非尝试启动浏览器预览。具体有两种实现方式：

方式1：转换为原始HTML输出 #

在代码中将生成的gt表格转换为原始HTML字符串，Quarto会自动渲染该内容：

my_table <- mtcars[1:10,]   # 取前10行数据
my_table |> 
  gt() |> 
  as_raw_html()

方式2：配合代码块results='asis'选项 #

在Quarto的webr代码块中添加results='asis'参数，确保输出的HTML被直接解析渲染：

my_table <- mtcars[1:10,]
my_table |> 
  gt() |> 
  as_raw_html()

说明 #

webr运行在浏览器的WebAssembly沙箱中，所有输出必须是能直接嵌入网页的格式。通过将gt表格转换为HTML输出，就能绕过其默认的浏览器预览逻辑，适配webr环境的输出要求。

内容的提问来源于stack exchange，提问作者Ray