Why Astro ships zero JavaScript by default - Performance Evidence

Performance: Why Astro ships zero JavaScript by default

HIGH IMPACT

This affects page load speed by reducing the amount of JavaScript sent to the browser, improving initial load and interactivity.

Delivering a fast-loading website with minimal JavaScript

Astro

export default function Page() {
  return <h1>Hello, static content!</h1>;
}

No JavaScript is shipped by default, so the page loads faster and renders immediately.

📈 Performance Gainsaves 100kb+ bundle size, improves LCP significantly

Delivering a fast-loading website with minimal JavaScript

Astro

import HeavyComponent from './HeavyComponent.jsx';
export default function Page() {
  return <HeavyComponent />;
}

This pattern ships all JavaScript for HeavyComponent to the client even if it's not interactive, increasing bundle size and load time.

📉 Performance Costadds 100kb+ to bundle, blocks rendering until JS loads

Performance Comparison

Pattern	DOM Operations	Reflows	Paint Cost	Verdict
Shipping all JS by default	High (many nodes from JS components)	Multiple reflows due to JS execution	High paint cost from dynamic content	[X] Bad
Shipping zero JS by default	Low (static HTML only)	Single initial reflow	Low paint cost with static content	[OK] Good

Rendering Pipeline

By shipping zero JavaScript by default, Astro reduces the JavaScript parsing and execution steps in the browser, allowing faster style calculation, layout, and paint.

→JavaScript Parsing

→Style Calculation

→Layout

→Paint

⚠️ BottleneckJavaScript Parsing and Execution

Core Web Vital Affected

LCP

This affects page load speed by reducing the amount of JavaScript sent to the browser, improving initial load and interactivity.

Optimization Tips

1Avoid shipping JavaScript unless needed for interactivity.

2Static HTML renders faster and improves LCP.

3Load JavaScript lazily or on user interaction to save resources.

Performance Quiz - 3 Questions

What is the main performance benefit of Astro shipping zero JavaScript by default?

A Better SEO because of more JavaScript

B Faster initial page load and smaller bundle size

C More interactive features available immediately

D Improved server-side rendering speed

DevTools: Network

How to check: Open DevTools, go to Network tab, reload page, filter by JS files, and observe total JS size loaded.

What to look for: Look for minimal or zero JavaScript files loaded on initial page load to confirm zero JS shipping.

Practice

1. Why does Astro ship zero JavaScript by default to the browser?

easy

A. Because Astro does not support JavaScript at all

B. To make websites faster by sending only necessary code

C. To force developers to write all code in CSS

D. Because JavaScript is not supported in modern browsers

Solution

1. Step 1: Understand Astro's default behavior

   Astro sends no JavaScript to the browser unless explicitly added.

2. Step 2: Reason why this is beneficial

   Sending less JavaScript makes websites load faster and simpler.

3. Final Answer:

   To make websites faster by sending only necessary code -> Option B

4. Quick Check:

   Astro ships zero JS by default to improve speed [OK]

Hint: Astro avoids sending JS unless needed to speed up sites [OK]

Common Mistakes:

• Thinking Astro doesn't support JavaScript at all
• Believing JavaScript is disabled in browsers
• Assuming Astro forces CSS-only coding

2. Which syntax correctly adds JavaScript to an Astro component using client directives?

easy

A. <MyComponent client-load />

B. <MyComponent load:client />

C. <MyComponent client:load />

D. <MyComponent loadClient />

Solution

1. Step 1: Recall Astro client directive syntax

   Astro uses client:load to add JavaScript loading behavior.

2. Step 2: Compare options to correct syntax

   Only <MyComponent client:load /> uses the correct client:load syntax.

3. Final Answer:

   <MyComponent client:load /> -> Option C

4. Quick Check:

   Correct client directive syntax is client:load [OK]

Hint: Look for colon between 'client' and 'event name' [OK]

Common Mistakes:

• Swapping order of 'client' and 'load'
• Using hyphens instead of colon
• Omitting the colon entirely

3. Given this Astro component snippet:

<MyWidget client:idle />

What happens when the page loads?

medium

A. JavaScript for MyWidget loads after a user click

B. JavaScript for MyWidget loads immediately on page load

C. JavaScript for MyWidget never loads

D. JavaScript for MyWidget loads only when the browser is idle

Solution

1. Step 1: Understand the client:idle directive

   The client:idle directive loads JavaScript when the browser is idle.

2. Step 2: Determine behavior on page load

   JavaScript does not load immediately but waits until the browser is idle.

3. Final Answer:

   JavaScript for MyWidget loads only when the browser is idle -> Option D

4. Quick Check:

   client:idle delays JS load until idle [OK]

Hint: client:idle means load JS when browser is idle [OK]

Common Mistakes:

• Assuming JS loads immediately on page load
• Confusing client:idle with client:load
• Thinking JS never loads

4. You wrote this Astro code:

<MyButton client:load>Click</MyButton>

But the JavaScript is not loading. What is the likely error?

medium

A. You used client:load on a component that does not export JavaScript

B. You forgot the self-closing slash /> in the component tag

C. Astro does not support client directives on components

D. You need to import JavaScript separately in a script tag

Solution

1. Step 1: Check client directive usage

   Using client:load requires the component to have JavaScript to load.

2. Step 2: Identify if component exports JS

   If MyButton has no JavaScript, the directive does nothing.

3. Final Answer:

   You used client:load on a component that does not export JavaScript -> Option A

4. Quick Check:

   client:load needs JS in component to work [OK]

Hint: Ensure component has JS before using client directives [OK]

Common Mistakes:

• Thinking self-closing slash is mandatory for client directives
• Believing Astro disallows client directives
• Assuming separate script import is always needed

5. You want to add interactive JavaScript only to a button that appears inside a large Astro page. Which approach best follows Astro's zero JavaScript philosophy?

hard

A. Add client:load only to the button component and keep the rest JS-free

B. Add JavaScript globally to the whole page to ensure button works

C. Write all JavaScript inline in the page without client directives

D. Use client:visible on the entire page component

Solution

1. Step 1: Understand Astro's zero JS principle

   Astro sends no JS unless explicitly added to components needing it.

2. Step 2: Choose minimal JS loading

   Adding client:load only to the button loads JS just where needed.

3. Step 3: Avoid global or unnecessary JS

   Global JS or inline scripts increase bundle size and slow page.

4. Final Answer:

   Add client:load only to the button component and keep the rest JS-free -> Option A

5. Quick Check:

   Minimal JS on needed components fits Astro philosophy [OK]

Hint: Add JS only to interactive parts, not whole page [OK]

Common Mistakes:

• Adding JS globally instead of per component
• Using inline scripts without directives
• Applying client:visible to entire page unnecessarily