# tui.webpack.safe-umd-plugin

**Repository Path**: mirrors_nhn/tui.webpack.safe-umd-plugin

## Basic Information

- **Project Name**: tui.webpack.safe-umd-plugin
- **Description**: Webpack plugin to handle optional dependencies safely when using libraryTarget: umd
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-25
- **Last Updated**: 2026-03-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# safe-umd-webpack-plugin

Webpack plugin to handle optional dependencies safely when using `libraryTarget: umd`.

## When to use

When using `umd` as a libraryTarget with config like :

```js
module.exports = {
  entry: './src/index.js',
  output: {
    library: ['my', 'module'],
    libraryTarget: 'umd',
    filename: 'bundle.js'
  },
  externals: {
    'my-ext-module': {
      commonjs: 'my-ext-module',
      commonjs2: 'my-ext-module',
      amd: 'my-ext-module',
      root: ['my', 'ext', 'module']
    }
  }
}; 
```

You can't use optional dependencies for a root (namespace) because of the generated code like :

```js
root["my"] = root["my"] || {}, root["my"]["module"] = factory(root["my"]["ext"]["module"]);
```

This plugin replace code above to safely access the namespace with code like :

```js
root["my"] = root["my"] || {}, root["my"]["module"] = factory(root["my"] && root["my"]["ext"] && root["my"]["ext"]["module"]);
```

## How to use

### Install

```
npm install safe-umd-webpack-plugin --save-dev
```

### Config

```js
// webpack.config.js

var SafeUmdPlugin = require('safe-umd-webpack-plugin');

// ...
module.exports = {
  // ...
  plugins: [
    //...
    new SafeUmdPlugin()
  ]
}
```