canirequire › CommonJS › @smithy/credential-provider-imds
Is @smithy/credential-provider-imds ESM-only? Can you require() it?
AWS credential provider that sources credentials from the EC2 instance metadata service and ECS container metadata service
Last verified Sep 9, 2026 against @smithy/credential-provider-imds@4.5.2. Markdown · JSON
CommonJS CommonJS — require() works on every Node.js version we test
@smithy/credential-provider-imds ships CommonJS only. require("@smithy/credential-provider-imds") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. The package declares Node.js >=18.0.0. import "@smithy/credential-provider-imds" also works because Node.js and Bun can import CommonJS from ES modules, but only the default export is guaranteed; named imports depend on Node's static analysis of the module.
It also declares a "module" field, so bundlers such as webpack, Vite and esbuild pick up an ESM build for tree-shaking.
What to do
- require("@smithy/credential-provider-imds") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. The package declares Node.js >=18.0.0.
- From ES modules use the default import: import credentialProviderImds from "@smithy/credential-provider-imds"; then destructure. Named imports only work when Node.js can statically detect the exports.
- TypeScript: types are bundled; install nothing extra.
Does @smithy/credential-provider-imds@4.5.2 actually load? Runtime test results
Installed and executed on Sep 9, 2026 with require("@smithy/credential-provider-imds") from a CommonJS file and import "@smithy/credential-provider-imds" from an ES module.
| Runtime | require("@smithy/credential-provider-imds") | import "@smithy/credential-provider-imds" |
|---|---|---|
| Node.js 18 | ✓ works | ✓ works |
| Node.js 20 | ✓ works | ✓ works |
| Node.js 22 | ✓ works | ✓ works |
| Node.js 24 | ✓ works | ✓ works |
| Node.js 26 | ✓ works | ✓ works |
| Bun 1.4.0 | ✓ works | ✓ works |
How to import @smithy/credential-provider-imds
ES modules (import)
import credentialProviderImds from "@smithy/credential-provider-imds";Named imports from a CommonJS package only work when Node.js can statically detect them. If a named import fails, use the default import and destructure.
CommonJS (require)
const credentialProviderImds = require("@smithy/credential-provider-imds");Module format by version
Derived from the type, main and exports fields of every stable release on npm, corrected where a runtime test of that version contradicted them (109 versions; the newest 60 shown).
| Versions | Format | First published |
|---|---|---|
| 3.2.5 – 4.5.2 | CommonJS | Oct 21, 2024 |
Frequently asked
Is @smithy/credential-provider-imds ESM-only?
@smithy/credential-provider-imds@4.5.2 is a CommonJS package. @smithy/credential-provider-imds ships CommonJS only. require("@smithy/credential-provider-imds") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. The package declares Node.js >=18.0.0. import "@smithy/credential-provider-imds" also works because Node.js and Bun can import CommonJS from ES modules, but only the default export is guaranteed; named imports depend on Node's static analysis of the module.
Can I import @smithy/credential-provider-imds with ES module syntax?
Yes. import credentialProviderImds from "@smithy/credential-provider-imds" works in Node.js and Bun because they support importing CommonJS modules. Named imports work only when Node.js can statically detect the exports.
Does @smithy/credential-provider-imds work in Bun?
Yes. import "@smithy/credential-provider-imds" loaded successfully in Bun 1.4.0 on Sep 9, 2026.
Does @smithy/credential-provider-imds ship TypeScript types?
Yes. @smithy/credential-provider-imds bundles its own type declarations; no @types package is needed.
Links
Other commonjs packages
- debug 4.4.3CommonJS
- semver 7.8.5CommonJS
- ms 2.1.3CommonJS
- picomatch 4.0.7CommonJS
- ajv 8.20.0CommonJS
- source-map 0.8.0CommonJS
- react-is 19.2.8CommonJS
- readable-stream 4.7.0CommonJS
Similar popularity
- date-fns 4.4.0Dual
- jest-matcher-utils 30.5.1Dual
- loose-envify 1.4.0CommonJS
- dequal 2.0.3Dual
- object.values 1.2.1CommonJS
- htmlparser2 12.0.0ESM-only
- data-urls 7.0.0CommonJS
- string.prototype.trimend 1.0.10CommonJS