@descope/outbound-applications-widget

中文文档
0.7.21发布于 2026/11/08MITTypeScriptESM + CJS近 30 天下载 126.3万

Descope 应用程序门户部件

中文使用文档
文档目录13 节
  1. 设置
  2. 创建一个 .env 文件
  3. 示例
  4. 认证
  5. 启动部件
  6. 建筑
  7. 项目结构
  8. API 密码
  9. 混合
  10. 状态
  11. 司机
  12. 德维
  13. 使用模拟屏幕

@ descope/出界应用程序-widget

设置

创建一个 .env 文件

在部件包中创建 .env 包含的文件;

DESCOPE_BASE_URL=   # env base url
DESCOPE_PROJECT_ID= # project ID
DESCOPE_WIDGET_ID=  # default: outbound-applications-widget
DEBUG_MODE=         # "true" / "false", default: "false"
DESCOPE_THEME=      # "light" / "dark" / "os", default: "light"

示例

// replace x.x.x with the latest release of the widget: https://www.npmjs.com/package/@descope/outbound-applications-widget
<script src="https://descopecdn.com/npm/@descope/[email protected]/dist/index.js"></script>
<descope-outbound-applications-widget
  base-url="<DESCOPE_BASE_URL>"
  project-id="<DESCOPE_PROJECT_ID>"
  tenant="<DESCOPE_TENANT>"
  debug="<DEBUG_MODE>"
  theme="<DESCOPE_THEME>"
  widget-id="<DESCOPE_WIDGET_ID>"
></descope-outbound-applications-widget>

<script>
  function onLogout(error) {
    window.location.reload();
  }
  const descopeWidgetEle = document.getElementsByTagName('descope-outbound-applications-widget')[0];
  descopeWidgetEle.logout = onLogout;
</script>

认证

要使用部件, 您必须登录 如果您没有得到认证, 登录流程将先运行, 登录后将打开部件

启动部件

运行 npm start 启动部件.

建筑

项目结构

  • /app - 包含 index.html
  • /lib - 部件的源代码
  • lib/widget - 与部件有关的执行
  • lib/widget/api - 与API通话有关的逻辑
  • lib/widget/mixins - 部件特定逻辑
  • lib/widget/state - 国家管理逻辑

API 密码


混合

部件由混音组成,每个混音包含特定的逻辑部分,有时会曝光一个可用于其他混音的API.

混音可以由相上而下组成,这样我们就可以通过将几个混音组合在一起来创造出新的混音.

混合创建者

创建混音符的函数,可以得到配置,并返回混音符的函数.

单通混音

由于混合剂是可相容的,在某些情况下我们希望确保混合剂只装入一次. 例如:当它的逻辑不需要在由不同的混合体组成时运行多次时.

对于本案,我们有一个包装功能(createSingletonMixin),以确保混合剂只装入一次,无论会装入多少次.

混音器应该用 createSingletonMixin 包装功能,除非有多次运行混音逻辑的原因.

状态

我们正在使用几种工具来处理部件的状态:

司机

一个抽象层,为组件提供 API,并能够处理部件内组件之间的相互作用.

使用驱动器的动机是将部件的代码从组件的执行中解开,因此重要的是只使用驱动器与组件互动(而不是依赖组件的执行细节).

德维

使用模拟屏幕

由于屏幕被动态获取, 当为部件开发新屏幕时, 您可能想要使用模拟模板 。 为此,只需将呼叫改为: fetchWidgetPage 包含您 HTML 的字符串.

版本与发布记录

@descope/outbound-applications-widget 共发布 222 个版本,首次发布于 2025/08/04;过去 12 个月发布了 168 个版本。

版本发布日期距今
0.7.21latest2026/11/083 天前
0.0.0-next-8d9f5c5a-20261108next2026/11/083 天前
0.0.0-next-4d93b95d-202611052026/11/056 天前
0.7.202026/11/056 天前
0.0.0-next-41289441-202611042026/11/047 天前
0.7.192026/11/038 天前

关于 @descope/outbound-applications-widget 的常见问题

@descope/outbound-applications-widget 是什么?

Descope 应用程序门户部件

如何安装 @descope/outbound-applications-widget?

在项目目录运行 npm install @descope/outbound-applications-widget,或使用 pnpm add / yarn add / bun add。

@descope/outbound-applications-widget 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@descope/outbound-applications-widget 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@descope/outbound-applications-widget 可以商用吗?

@descope/outbound-applications-widget 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@descope/outbound-applications-widget 的下载量有多少?

根据 npm 官方下载统计,@descope/outbound-applications-widget 在 2026/10/12 – 2026/11/10 这 30 天内被下载 1,263,417 次,日均约 42,114 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@descope/outbound-applications-widget 还在维护吗?

最新版本 0.7.21 发布于 2026/11/08(3 天前);至今共发布 222 个版本,其中过去 12 个月发布了 168 个;首次发布于 2025/08/04。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。