# bun/no-eager-native-addon

> Disallow loading a `.node` native addon as soon as the module is loaded

A native addon is a shared library. Loading one takes time, and it throws if the file is missing or was built for another platform. If that happens at the top level of a file, everything that imports the file fails to start, even code that never calls the addon. Load it in the function that first needs it.

The rule looks at `import` and `export ... from` statements, `require()`, and `import()` with a path that ends in `.node`.

{/* Generated by src/codegen/lint-rule-docs.ts. Do not edit this section. */}

## Configure

Off by default. To turn it on:

```toml bunfig.toml
[lint.rules]
"bun/no-eager-native-addon" = "error" # or "warn"
```

{/* End of the generated section. */}

## Examples

Reported:

{/* bad */}
```js
const native = require("./build/Release/resize.node");

export function resize(image, width) {
  return native.resize(image, width);
}
```

{/* bad */}
```js
import native from "./build/Release/resize.node";
```

Not reported:

{/* good */}
```js
let native;

export function resize(image, width) {
  native ??= require("./build/Release/resize.node");
  return native.resize(image, width);
}
```

A type-only import doesn't load anything:

{/* good */}
```ts
import type { Resizer } from "./build/Release/resize.node";
```