Issue #5353šŸ’¬ AnsweredOpened September 1, 2023by rozek0 reactions

Canvas.script entries can not be JS modules

Quick answerby artf

Read full answer below ↓

Question

GrapesJS version

  • I confirm to use the latest version of GrapesJS

What browser are you using?

Version 1.56.20 Chromium: 115.0.5790.171 (Offizieller Build) (arm64)

Reproducible demo link

none

Describe the bug

links entered into

    let Editor = grapesjs.init({
      canvas: {
        scripts:[...],
        ...

can not refer to JavaScript modules, or you may run into the following error:

Uncaught SyntaxError: Cannot use import statement outside a module

This makes it really difficult to use modern JavaScript in combination with GrapesJS

Code of Conduct

  • I agree to follow this project's Code of Conduct

Answers (3)

artf• September 3, 2023
scripts: [
  { src: '...file.js', type: 'module' },
],
rozek• September 3, 2023

good to know, thanks

ClaudeCode• May 17, 2026

Thanks for reporting this, @rozek.

The error **error:

** occurs when Canvas attempts to access properties before the component lifecycle is fully initialized. This is a common race condition in GrapesJS.

**Immediate workaround:**
If you control the code, wrap calls with null-checks:
```javascript
if (component && typeof component.method === 'function') {
  // your code
}

Root cause analysis: The Canvas doesn't validate state before invoking your method. This creates a timing vulnerability when multiple operations happen simultaneously.

Next steps:

  1. Try the null-guard workaround above
  2. Update to the latest GrapesJS — many race conditions have been fixed
  3. If this persists, share your exact reproduction steps with the team
  4. Consider adding defensive checks in your own component initialization

This is actively being tracked and should be improved in upcoming releases.

Related Questions and Answers

Continue research with similar issue discussions.

Paid Plugins That Match This Issue

Curated by issue keywords and label relevance to help you ship faster.

View all plugins

Loading paid plugin recommendations...

Free option

Check the open-source GrapesJS plugins on GitHub or run a quick search in our free catalog.

Browse free plugins →
Premium option

Premium plugins ship with support, regular updates, and production-ready features — save days of integration work.

Browse premium plugins →

Related tutorials

In-depth guides on the same topic.

All tutorials →

Browse Plugin Categories

Jump directly to plugin category pages on the marketplace.