Course contentsShow
← JavaScript
Lesson 20 of 2,7231. JavaScript FoundationsFree lesson

Why Runtime Differences Matter

Code portable across engines may break across runtimes due to differing APIs; knowing your runtime is key.

Why Runtime Differences Matter

What you'll learn: Why code that runs perfectly in one JavaScript environment might fail or behave differently in another.

You've learned about different JavaScript engines (V8, SpiderMonkey, JavaScriptCore) and different runtimes (Browser, Node.js, Deno, Bun). Here's the crucial insight: the engine runs JavaScript, but the runtime provides the extra tools.

The Core Problem

Imagine you have a universal remote control (JavaScript) that works with any TV brand (engine). The remote's basic buttons—power, volume, channels—work everywhere. But each TV manufacturer adds their own special features: voice control, streaming apps, gaming modes. Those extras aren't part of the remote itself; they're built into each TV.

Similarly, core JavaScript works across all environments. But when you try to use runtime-specific features, portability breaks:

  • Browser runtime gives you document, window, fetch for web pages
  • Node.js runtime gives you fs (file system), http (servers), process
  • Deno runtime has different security permissions and uses URLs for imports
  • Bun runtime has its own fast APIs

Why This Matters

If you write code using document.getElementById() (browser-only), it will crash in Node.js—Node.js has no concept of HTML documents. If you write Node.js code using fs.readFile() to access files, it won't work in browsers—browsers don't let websites freely read your computer's files for security reasons.

Understanding which runtime you're targeting prevents confusing errors and helps you choose the right APIs for your project.

Key Takeaway: JavaScript code is portable across engines, but runtime APIs are environment-specific—always know where your code will run.