.svelte 解析、loader 设置以及 Svelte 客户端别名。
什么场景适合用 Svelte
- 你希望 popup、options、sidebar 或新标签页 UI 拥有更小的运行时。
- 你偏好以组件为先、语法简洁的写法。
- 你希望选择一个既能用于扩展页面、又能用于 content script UI 挂载的框架。
模板示例
new-svelte

content-svelte

在现有扩展中使用
安装 Svelte:svelte-loader 包缺失时,构建报错会指明与内置工具链匹配的确切版本。报错中的安装命令会按你项目实际使用的包管理器给出。
开发期行为
当 Extension.js 检测到 Svelte 时,会:- 启用
.svelte文件解析。 - 在 JS 框架管线中配置 Svelte loader,并在开发期启用热重载,让改动过的组件无需整页刷新就能更新。
- 应用 Svelte 客户端别名(例如
svelte、svelte/store和svelte/reactivity)。
用法示例
在扩展页面中
new App(...) 与 app.$destroy())
在模板所安装的版本上会抛出 component_api_invalid_new。
在 content_script 文件中
对于 content script,创建一个挂载节点,并在默认导出中返回一个清理函数。这样 Extension.js 可以在开发期安全地重新挂载:
<style> 块在 content script 里会生效。它落在哪里取决于 Svelte 编译器的 css 选项:
- 默认设置。 Extension.js 把这个块编译成一份独立的样式表。构建会把它以一个
<style>元素加进 document,所以它进不了 shadow root。 css: "injected"。 编译后的组件自带样式,Svelte 5 会在组件挂载时把它们加进去。挂载在 shadow root 里的组件,它的<style>元素会放进那个 root。其他组件的<style>元素会放进 document 的<head>。
svelte.loader.js 文件读取 Svelte loader 选项。在 compilerOptions 下设置这个选项:
svelte.loader.mjs、svelte.loader.ts 或 svelte.loader.mts。从 4.2.0 之后的版本起,加载时抛出异常的 loader 选项文件会让构建以 E_CONFIG_LOAD 停止。消息会点名该文件和原因。
当 Svelte 编译器比你项目中的 svelte 包更新时,运行时会跟随编译器,并有一条警告说明这一点。从 4.2.0 之后的版本起,这条警告带有代码 W_MANAGED_DEP_CONFLICT,并且 svelte 只从你的项目读取,永远不会从命令运行所在的文件夹读取。
最佳实践
- 让 Svelte 组件专注于 UI,把浏览器 API 的编排放到专门的模块里。
- 在 content script 里始终返回清理函数,保证重新挂载行为可预期。
- 先在扩展页面里使用 Svelte,等功能边界清晰后,再扩展到 content script UI。
下一步
- 进一步了解 TypeScript 支持。
- 阅读 Content scripts 中的 content script 契约。

