Bun Macros Optimization FAQs

Question 1

What types of data can Bun macros return?

Accepted Answer

Macros must return JSON-serializable values such as strings, numbers, booleans, arrays, or plain objects, as these values must be represented as literals in the final output.

Question 2

What are Bun macros?

Accepted Answer

Bun macros are functions that run during the bundling process rather than at runtime, allowing the results to be inlined directly into your source code for maximum performance.

Question 3

Can Bun macros perform asynchronous operations?

Accepted Answer

Yes, Bun macros support async/await, making them ideal for fetching remote schemas or reading files from the disk during the bundling process.

Question 4

How do I import a Bun macro?

Accepted Answer

Macros are imported using the specific syntax: import { function } from './file' with { type: 'macro' }. This tells the bundler to execute the function during the build.

Question 5

Do macros run when I use 'bun run'?

Accepted Answer

By default, macros only execute during the 'bun build' process. When using 'bun run' on source files, they behave as standard JavaScript imports unless the loader is specifically configured.

Bun Macros Optimization

Key Features

Use Cases

Bun Macros Optimization

Key Features

Use Cases