Cannot read properties of null (reading 'hasFocus') in Canvas module
Thanks for reporting this, @saeedhbi. Great suggestion about Cannot read properties of null (reading 'hasFocus') in Canvas module! While this specific feature isn't yet in the core API, there are several ways to achieve similar behavior. Using the event system: Alternative approaches: Listen to selector:add for CSS se...
Read full answer below ↓Question
GrapesJS version
- I confirm to use the latest version of GrapesJS
What browser are you using?
Chrome (versions 142-144), Safari (versions 16.3, 26.1), Maybe others too
Reproducible demo link
https://jsfiddle.net/saeedhbi/tqfe7p04/
Describe the bug
How to reproduce the bug?
- Initialize a GrapeJS editor (v0.22.11 or v0.22.14)
- Before the iframe is fully loaded, press a keyboard shortcut (e.g., Ctrl+Z, Delete, or any command key)
- Command system calls
Canvas.hasFocus()before iframe is ready - Observe
TypeError: Cannot read properties of null (reading 'hasFocus')
What is the expected behavior?
The hasFocus() method should safely handle cases where getDocument() returns null or undefined:
- Return
falsewhen document is unavailable (safe default) - Not throw an exception
- Allow keyboard commands to fail gracefully rather than crash
What is the current behavior?
GrapeJS throws a TypeError when the Canvas module's hasFocus() method attempts to call this.getDocument().hasFocus() while the document is null. This occurs when the editor iframe is destroyed, not yet initialized, or during state transitions.
Error messages:
Chrome:
TypeError: Cannot read properties of null (reading 'hasFocus')
Safari:
TypeError: null is not an object (evaluating 'this.getDocument().hasFocus')
Root cause: The Canvas module's hasFocus() method assumes getDocument() will always return a valid document object. However, there are several states where this fails:
- Iframe not ready - Editor initialized before iframe loads
- Editor destroyed - User navigates away during async operation
- Race condition - Keyboard event fires during editor state transition
- DOM replaced - Iframe replaced while keyboard listener active
Code of Conduct
- I agree to follow this project's Code of Conduct
Answers (1)
Thanks for reporting this, @saeedhbi.
Great suggestion about Cannot read properties of null (reading 'hasFocus') in Canvas module! While this specific feature isn't yet in the core API, there are several ways to achieve similar behavior.
Using the event system:
editor.on('component:update', (component) => {
// your logic here
});
Alternative approaches:
- Listen to
selector:addfor CSS selector changes - Use
selector:customfor custom rules - Tap into the
change:*events for fine-grained tracking - Build a plugin that extends the editor with this capability
Making it official: If this feature would benefit many users, consider opening a formal Feature Request on the GrapesJS repo with:
- A detailed use case
- Code example showing the desired behavior
- Why this matters for your workflow
The core team is receptive to well-motivated feature requests backed by real use cases.
Related Questions and Answers
Continue research with similar issue discussions.
Issue #6705
TypeError: Cannot read properties of undefined (reading 'toLowerCase') in keyboard handler
GrapesJS version [x] I confirm to use the latest version of GrapesJS What browser are you using? All browsers (Chrome, Safari, Firefox, Edg...
Issue #3861
JS error when press "s" or "w" key - Cannot read properties of undefined (reading 'indexOf')
GrapesJS version [X] I confirm to use the latest version of GrapesJS What browser are you using? Chrome Version 94.0.4606.81 (Official Buil...
Issue #5743
XSS vulnerability in iframe attribute src
GrapesJS version [X] I confirm to use the latest version of GrapesJS What browser are you using? Edge v122 Reproducible demo link https://j...
Issue #5334
Selection of custom component type not working in the canvas
GrapesJS version [X] I confirm to use the latest version of GrapesJS What browser are you using? Chrome, Opera, Edge, etc Reproducible demo...
Paid Plugins That Match This Issue
Curated by issue keywords and label relevance to help you ship faster.
Loading paid plugin recommendations...
Check the open-source GrapesJS plugins on GitHub or run a quick search in our free catalog.
Browse free plugins →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.
Tutorial
Find the Right GrapesJS Plugin in Seconds: Smarter Discovery Is Live
We're shipping a set of discovery upgrades. New label filters, a proper compatibility switch for GrapesJS vs Studio, one-click and a smarter sort bar.
Tutorial
GJS Market 2.0 - Donations, Tracking, Labels and Better Product Discovery
We’ve rolled out a new set of GrapesJS marketplace updates across GJS Market, focused on improving how creators distribute products
Tutorial
Preset DevFuture 2.0 — New Update Released
Preset continues evolving as a clean, production-ready starting point for building visual editors powered by GrapesJS
Browse Plugin Categories
Jump directly to plugin category pages on the marketplace.