diff --git a/src/docs/guide/usage/minifier/dead-code-elimination.md b/src/docs/guide/usage/minifier/dead-code-elimination.md index f110b162cc..a260fe2409 100644 --- a/src/docs/guide/usage/minifier/dead-code-elimination.md +++ b/src/docs/guide/usage/minifier/dead-code-elimination.md @@ -255,3 +255,20 @@ const jQuery = $; // output (with `compress.treeshake.propertyReadSideEffects: false`) ``` + +### Ignoring Invalid Import Statement Side Effects + +By default, Oxc minifier assumes that import statements have side effects. This is because import statements have side effects in the following cases: + +- the import cannot be resolved +- the import name is not exported from the imported module + +You can tell Oxc minifier to ignore those possibilities by setting `compress.treeshake.invalidImportSideEffects` option to `false`. + +```js +// input +import { existing } from "cannot-be-resolved"; +import { missing } from "somewhere"; + +// output (with `compress.treeshake.invalidImportSideEffects: false`) +```