Настройка библиотеки как внешней в веб-пакете не работает с UMD в качестве libraryTarget

Question

Я пробовал это последние два дня, и я не могу заставить его работать так, как ожидалось: я хочу создать свою собственную библиотеку JavaScript и зарегистрировать ее в уже существующем пространстве имен ("OCA" - в данном конкретном случае). И, как вы, наверное, понимаете, я не хочу, чтобы меня заставляли обходиться без современных подходов, таких как безопасность типов с помощью машинописи или модулей.

Поэтому я использую Webpack 2 и libraryTarget: umd зарегистрировать вывод в "OCA.Ocr" (моя библиотека называется "Ocr"). Это работает как задумано, но когда дело доходит до того, что я хочу использовать, например, underscorejs, так как он будет доступен глобально в приложении, в которое библиотека должна быть доставлена, я не могу заставить его работать. Я следовал за документацией конфигурации webpack, и там говорится, что вариант конфигурации externals должен быть подходящим:

externals: { // object
    angular: "this angular", // this["angular"]
    react: { // UMD
      commonjs: "react",
      commonjs2: "react",
      amd: "react",
      root: "React"
    }
  }
  // Don't follow/bundle these modules, but request them at runtime from the environment

Я использовал его, как предложено в руководстве, но он не работает:

/* global __dirname, require, module*/

const webpack = require("webpack");
const UglifyJsPlugin = webpack.optimize.UglifyJsPlugin;
const path = require("path");

module.exports = function (env) {
  let target = env.target;

  let libraryName = ["OCA", "Ocr"];

  let plugins = [];
  let outputFile;

  if (target === "production") {
    plugins.push(new UglifyJsPlugin({ minimize: true }));
  }
  outputFile = "ocr[name].min.js";

  const config = {
    entry: {
      app: __dirname + "/src/app.ts",
      personal: __dirname + "/src/personal.ts"
    },
    output: {
      path: __dirname + "/dist",
      filename: outputFile,
      library: libraryName,
      libraryTarget: "umd",
      umdNamedDefine: true
    },
    module: {
      rules: [
        {
          test: /\.ts$/,
          enforce: "pre",
          loader: "tslint-loader",
          options: {
            tsConfigFile: "tsconfig.app.json",
          }
        },
        {
          test: /\.ts?$/,
          loader: "ts-loader",
          exclude: /node_modules/,
          options: {
            configFileName: "tsconfig.app.json"
          }
        }
      ],
    },
    resolve: {
      modules: [path.resolve("./src")],
      extensions: [".ts"],
    },
    externals: {
      underscore: { // UMD
        commonjs: "underscore",
        commonjs2: "underscore",
        amd: "underscore",
        root: "_"
      }
    },
    plugins: plugins,
  };

  return config;

}

мой app.ts файл, который использует библиотеку подчеркивания (например, _.defer метод, который, конечно, не всегда лучший) выглядит так:

import _ from 'underscore';

export class App {

    constructor() {
        _.defer(() => {
            console.log('test');
        });
    }
}

export let $app: App = new App();

Я включил его в приложение и также проверил, загружается ли библиотека underscorejs до того, как моя библиотека загружается браузером, но вывод консоли по-прежнему гласит:

Ошибка типа: underscore_1.default не определено

Скомпилированный вывод выглядит следующим образом (возможно, это немного помогает):

(function webpackUniversalModuleDefinition(root, factory) {
    if(typeof exports === 'object' && typeof module === 'object')
        module.exports = factory(require("underscore"));
    else if(typeof define === 'function' && define.amd)
        define("Ocr", ["underscore"], factory);
    else if(typeof exports === 'object')
        exports["Ocr"] = factory(require("underscore"));
    else
    root["OCA"] = root["OCA"] || {}, root["OCA"]["Ocr"] =     factory(root["_"]);
})(this, function(__WEBPACK_EXTERNAL_MODULE_1__) {
return /******/ (function(modules) { // webpackBootstrap
/******/    // The module cache
/******/    var installedModules = {};
/******/
/******/    // The require function
/******/    function __webpack_require__(moduleId) {
/******/
/******/        // Check if module is in cache
/******/        if(installedModules[moduleId]) {
/******/            return installedModules[moduleId].exports;
/******/        }
/******/        // Create a new module (and put it into the cache)
/******/        var module = installedModules[moduleId] = {
/******/            i: moduleId,
/******/            l: false,
/******/            exports: {}
/******/        };
/******/
/******/        // Execute the module function
/******/        modules[moduleId].call(module.exports, module,     module.exports, __webpack_require__);
/******/
/******/        // Flag the module as loaded
/******/        module.l = true;
/******/
/******/        // Return the exports of the module
/******/        return module.exports;
/******/    }
/******/
/******/
/******/    // expose the modules object (__webpack_modules__)
/******/    __webpack_require__.m = modules;
/******/
/******/    // expose the module cache
/******/    __webpack_require__.c = installedModules;
/******/
/******/    // identity function for calling harmony imports with the correct     context
/******/    __webpack_require__.i = function(value) { return value; };
/******/
/******/    // define getter function for harmony exports
/******/    __webpack_require__.d = function(exports, name, getter) {
/******/        if(!__webpack_require__.o(exports, name)) {
/******/            Object.defineProperty(exports, name, {
/******/                configurable: false,
/******/                enumerable: true,
/******/                get: getter
/******/            });
/******/        }
/******/    };
/******/
/******/    // getDefaultExport function for compatibility with non-harmony     modules
/******/    __webpack_require__.n = function(module) {
/******/        var getter = module && module.__esModule ?
/******/            function getDefault() { return module['default']; } :
/******/            function getModuleExports() { return module; };
/******/        __webpack_require__.d(getter, 'a', getter);
/******/        return getter;
/******/    };
/******/
/******/    // Object.prototype.hasOwnProperty.call
/******/    __webpack_require__.o = function(object, property) { return     Object.prototype.hasOwnProperty.call(object, property); };
/******/
/******/    // __webpack_public_path__
/******/    __webpack_require__.p = "";
/******/
/******/    // Load entry module and return exports
/******/    return __webpack_require__(__webpack_require__.s = 2);
    /******/ })
/************************************************************************/
/******/ ([
/* 0 */,
/* 1 */
/***/ (function(module, exports) {

module.exports = __WEBPACK_EXTERNAL_MODULE_1__;

/***/ }),
/* 2 */
/***/ (function(module, exports, __webpack_require__) {

"use strict";

Object.defineProperty(exports, "__esModule", { value: true });
var underscore_1 = __webpack_require__(1);
var App = (function () {
    function App() {
        underscore_1.default.defer(function () {
            console.log('test');
        });
    }
    return App;
}());
exports.App = App;
exports.$app = new App();


/***/ })
/******/ ]);
});

Кто-нибудь знает, как это работает и что мне придется делать? Я полностью потерялся и теперь надеюсь на вашу помощь.

Кстати: это также не работает для меня.

Answer 1

У меня та же проблема, что и у вас, однако, если вы установите свойство var в опции libraryTarget, переменная перестанет быть неопределенной. Может быть, это поможет вам:

externals: {
    "lodash": { 
        var:'_'
    }
}

Answer 2

У вас есть 2 варианта. Рекомендую вариант №1.

Фактически, если вы используете UMD и планируем поддерживать node(в дополнение к commonjs, amd и browser) всегда устанавливайтеglobalObject: 'this'

Установлен output.globalObject к this, и используйте externals.root.

const config = {
    output: {
      library: libraryName,
      libraryTarget: "umd",
      globalObject: 'this' // <-- THIS IS THE IMPORTANT LINE FOR UMD+NODE
    },
    externals: {
      underscore: { // UMD
        commonjs: "underscore",
        commonjs2: "underscore",
        amd: "underscore",
        root: "_"
      }
    },
  };

output.globalObject

При нацеливании на библиотеку, особенно когда libraryTarget имеет значение umd, этот параметр указывает, какой глобальный объект будет использоваться для монтирования библиотеки. Чтобы сделать сборку UMD доступной как в браузерах, так и в Node.js, установите для параметра output.globalObject значение this.

Использовать externals.var вместо того externals.root.

    externals: {
      underscore: { // UMD
        commonjs: "underscore",
        commonjs2: "underscore",
        amd: "underscore",
        var: "_"
      }
    },

Это обходной путь и не требует настройкиglobalObject: 'this'