# @edx/new-relic-source-map-webpack-plugin 中文文档

规范地址：https://npmcn.com/package/%40edx/new-relic-source-map-webpack-plugin/

版本：2\.1\.0
npm 元数据更新时间：2026-07-10T14:29:58.541Z
中文译文更新时间：2026-11-13T07:49:39.787Z
软件包许可：AGPL-3\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40edx/new-relic-source-map-webpack-plugin
原文对照：https://npmcn.com/package/%40edx/new-relic-source-map-webpack-plugin/?lang=original
项目主页：https://github.com/edx/new-relic-source-map-webpack-plugin#readme
源码仓库：https://github.com/edx/new-relic-source-map-webpack-plugin

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：55.2 kB，19 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2021-08-19T20:30:00.808Z
- 最新版本发布：2023-05-23T13:01:49.454Z
- 近 30 天下载量：34721（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 0 个）

## 中文简介

将源地图上传到新遗迹中,作为webpack构建的一部分.

## 安装

```sh
npm install @edx/new-relic-source-map-webpack-plugin
```

也可以使用：`pnpm add @edx/new-relic-source-map-webpack-plugin`、`yarn add @edx/new-relic-source-map-webpack-plugin`、`bun add @edx/new-relic-source-map-webpack-plugin`

## README

## 新旧来源-地图-网包-插件

将源地图上传到新遗迹中,作为webpack构建的一部分.

## 安装

`npm install @edx/new-relic-source-map-webpack-plugin --save-dev`

## 设置

创建插件并添加到您的插件阵列中 .

`applicationId`, (中文(简体) ), `apiKey`,以及 `staticAssetUrl` 要求,除非 `noop` 实值 `true`,在下一节中完整列出选项.

```js
const NewRelicSourceMapPlugin = require('new-relic-source-map-webpack-plugin');

module.exports = {
    ...webpackConfig,
    plugins: [
        ...yourPlugins,
        new NewRelicSourceMapPlugin({
            applicationId: 'YOUR NEW RELIC APP ID',
            apiKey: process.env.NEW_RELIC_ADMIN_KEY,
            staticAssetUrl: 'http://examplecdn.com',
            noop: typeof process.env.NEW_RELIC_ADMIN_KEY === 'undefined', // upload source maps in prod builds only
        })
    ]   
}
```

如果你在用的话 `releaseName` 财务报告和审定财务报表 `releaseId`,确保每个建筑有一个或两个都是独一无二的 您使用 [`newrelic.addRelease`](https://docs.newrelic.com/docs/browser/new-relic-browser/browser-agent-spa-api/add-release) 用于识别释放的方法.

## 自定义

| 财产 | 类型 | 说明 |
| --- | :-: | --: |
| 应用程序Id | 字符串 | 定义的应用程序Id [这里](https://docs.newrelic.com/docs/browser/new-relic-browser/installation-configuration/copy-browser-monitoring-license-key-app-id) |
| 键 | 字符串 | API 密钥定义 [这里](https://docs.newrelic.com/docs/apis/rest-api-v2/requirements/api-keys) |
| 静态AssetUrl | 字符串 | 您的生产资产来自哪个领域。 写成完整的url 。 示例:"https://www.examplecdn.com" 互联网档案馆的存檔,存档日期2013-12-21 |
| 静态AssetUrl 构建器 | 函数 | 用于构建您 js 文件的 url 的函数 。 每个 Javascript 文件都会有四个参数: 静态 AssetUrl, 从您的 Webpack 配置的公开路径, 文件名, 和 [网包数据实例](https://github.com/webpack/webpack/blob/master/lib/Stats.js)默认为 `${removeLastCharIfSlash(url)}${removeLastCharIfSlash(publicPath)}/${file}` |
| 扩展名 | 正则 | 用于找到 js 文件的正则x 。 默认为 `/\.js$/` |
| 无 | 布尔 | 控制决定是否运行插件的布尔 。 设定为不想要上传资产到新遗迹的建筑 . |
| 释放Name | 字符串 | \[可选\]发布名称的独有标识符 |
| 释放Id | 字符串 | \[可选 发行标识符的独有版本 |
| 调用错误 | 函数 | \[可选\]一个用于错误回调的函数. 默认是 ``console.warn(`New Relic sourcemap upload error: ${err}`)`` |

## 常见问题

### @edx/new-relic-source-map-webpack-plugin 是什么？

将源地图上传到新遗迹中,作为webpack构建的一部分\.

### 如何安装 @edx/new-relic-source-map-webpack-plugin？

在项目目录运行 npm install @edx/new-relic-source-map-webpack-plugin，或使用 pnpm add / yarn add / bun add。

### @edx/new-relic-source-map-webpack-plugin 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/edx\_\_new-relic-source-map-webpack-plugin 是否存在。

### @edx/new-relic-source-map-webpack-plugin 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @edx/new-relic-source-map-webpack-plugin 可以商用吗？

@edx/new-relic-source-map-webpack-plugin 使用 AGPL-3\.0 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @edx/new-relic-source-map-webpack-plugin 的下载量有多少？

根据 npm 官方下载统计，@edx/new-relic-source-map-webpack-plugin 在 2026/10/13 – 2026/11/11 这 30 天内被下载 34,721 次，日均约 1,157 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @edx/new-relic-source-map-webpack-plugin 还在维护吗？

最新版本 2\.1\.0 发布于 2023/05/23（3 年前）；至今共发布 5 个版本，其中过去 12 个月发布了 0 个；首次发布于 2021/08/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。