プロジェクトビルド時の SourceMap アップロード¶

 npm install @cloudcare/webpack-plugin --D

// ....
const { SourceMapUploadWebpackPlugin } = require("@cloudcare/webpack-plugin")
module.exports = ({ mode }) => ({
  //.....
  devtool: "hidden-source-map",
  plugins: [
    //.....
    new SourceMapUploadWebpackPlugin({
      applicationId: "xxxxx", //  Guance アプリケーション appid
      apiKey: "xxxxxxxx", // open apikey
      server: "https://console.xxx-xxx.cn",
      filepaths: ["dist/"], // 検索するディレクトリ。ファイルまたはファイルディレクトリを指定可能
      logLevel: "verbose", // ログ出力レベル、任意
      root: "dist/", // 相対パスを計算する基準ディレクトリ、任意
      env: "production", // Guance アプリケーションの env、任意
      version: "1.0.0", // Guance アプリケーションの version、任意
    }),
  ],
})

interface Options {
  /**
   *
   * sourcemap を検索するファイル/ディレクトリ。
   * "extensions 設定" リストに一致し、"ignore 設定" に一致しないすべてのファイルが検索され、
   * sourcemap JSON または `//#sourceMappingURL=` コメントから生成ファイルとソースマップのペアを見つけ、ソースマップがアップロードされます。
   */
  filepaths: Array<string> | string

  /**
   * Guance プラットフォームで生成された openApi Key。生成方法は（https://docs.guance.com/ja/management/api-key/open-api/#_1）を参照
   */
  apiKey: string

  /**
   * Guance プラットフォームの OpenAPI サービス
   */
  server: string
  /**
   * Guance RUM アプリケーションに対応する applicationId（必須）
   */
  applicationId: string
  /**
   * Guance RUM アプリケーションに対応する version（任意）
   */
  version?: string
  /**
   * Guance RUM アプリケーションに対応する env（任意）
   */
  env?: string

  /**
   * 条件に一致するすべてのファイルのリストを取得するが、ファイルはアップロードしない。デバッグに使用可能
   */
  dryRun?: boolean

  /**
   * アップロード後、見つかったすべてのソースマップファイルを削除する。
   */
  deleteAfterUpload?: boolean
  /**
   * ソースマップが sourceMappingURL で生成ファイルと一致しない場合、ローカルディスクのファイル名で一致を試みる
   */
  matchSourcemapsByFilename: ?boolean

  /**
   * ディレクトリ内のファイル拡張子リスト
   * デフォルト [".js", ".map"].
   */
  extensions?: Array<string>

  /**
   * 無視するファイルリスト
   */
  ignore?: Array<string>

  /**
   * 相対パスを計算する基準ディレクトリ。sourcemaps アップロードの相対パスはエラー発生パスに含まれる必要があるため、
   * このパラメータはアップロードする相対ディレクトリを制御するためのものです。
   * デフォルト 実行ディレクトリから検索ディレクトリへの相対パス path.relative(process.cwd(), filepath)
   */
  root?: string
  /**
   * デバッグ時に使用するログレベル
   */
  logLevel?: "quiet" | "normal" | "verbose"
  /**
   * 実行失敗時にエラーを無視するかどうか。この設定により、エラーが発生してもコンパイルプロセスが中断されないようにします。デフォルト false（デフォルトではエラーが正常にスローされます）
   */
  warnOnFailure?: boolean
}

 const { SourceMapUploadWebpackPlugin } = require('@cloudcare/webpack-plugin')
 = require('@cloudcare/webpack-plugin')

module.exports = {
  // Ensure that Webpack has been configured to output sourcemaps,
  // but without the `sourceMappingURL` references in buidl artifacts.
  devtool: 'hidden-source-map',
  // ...
  plugins: [
    // Enable our plugin to upload the sourcemaps once the build has completed.
    // This assumes NODE_ENV is how you distinguish production builds. If that
    // is not the case for you, you will have to tweak this logic.
    process.env.NODE_ENV === 'production'
      ? [
          new SourceMapUploadWebpackPlugin({
            ...
            deleteAfterUpload: true,
            matchSourcemapsByFilename: true,
          }),
        ]
      : [],
  ],
}