---
title: "import/namespace"
description: "Require each property read from an `import * as` namespace to be exported by that file"
# Generated by src/codegen/lint-rule-docs.ts. Do not edit below this line.
plugin: "import"
aliases: ["import-x/namespace"]
kind: "problem"
category: "correctness"
default: "off"
fixable: "no"
typeAware: false
deprecated: false
---

With `import * as api from "./api"`, reading a name that `./api` doesn't export gives `undefined`, and nothing fails until you call it. Assigning to `api.save` throws, because a namespace object is read-only.

The rule reads the imported file and checks `api.name`, `const { name } = api` and `<api.Name />`. A computed read like `api[key]` can't be checked, so it's reported too unless you allow it.

It reads JavaScript and TypeScript files, including JSX. With an ESLint config it only reads `.js`, `.mjs` and `.cjs` files, unless `settings["import/extensions"]` lists others.

{/* 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]
"import/namespace" = "error" # or "warn"
```

Every option, set to its default:

```toml bunfig.toml
[lint.rules]
"import/namespace" = ["error", {
  allowComputed = false,
}]
```

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

## Examples

Reported:

{/* file "api.js" */}
```js
export function save(item) {}
export function load(id) {}
```

{/* bad {"count": 4} */}
```js
import * as api from "./api.js";

api.remove("draft");
const { update } = api;
api.save = () => {};

const action = "load";
api[action]("draft");
```

Not reported:

{/* file "api.js" */}
```js
export function save(item) {}
export function load(id) {}
```

{/* good */}
```js
import * as api from "./api.js";

api.save({ id: "draft" });
const { load } = api;
load("draft");
```

## Options

| Option | Default | What it does |
| --- | --- | --- |
| `allowComputed` | `false` | Allow computed reads such as `api[key]`. They aren't checked. |

{/* file "api.js" */}
```js
export function save(item) {}
export function load(id) {}
```

{/* good {"options": [{"allowComputed": true}]} */}
```js
import * as api from "./api.js";

const action = "load";
api[action]("draft");
```