Skip to main content

Overview

JavaScript offers the fastest path to building Noorle plugins. Using ComponentizeJS, you can compile standard JavaScript directly to WebAssembly components without a separate build toolchain.
JavaScript plugins share the same ComponentizeJS toolchain as TypeScript. If you prefer type safety, see the TypeScript guide.

Prerequisites

Quick Start

Working with External Data

JavaScript plugins can process and transform data:

Error Handling

Return structured errors so agents can understand what went wrong:

JavaScript vs TypeScript

Both use the same ComponentizeJS runtime and produce identical WASM output. The choice is purely about development experience.

Limitations

JavaScript plugins run in a WebAssembly sandbox. The following are not available:
  • fetch() or network APIs (use permissions for network access)
  • fs module (use declared filesystem permissions)
  • setTimeout / setInterval
  • Dynamic import()

Next Steps

Configuration

Full noorle.yaml reference

Permissions

Configure network and filesystem access

Publishing

Upload and version your plugin

TypeScript Guide

Add type safety to your plugin