Debug UI components JavaScript

Overview

This article describes how to define what UI components are used on a particular page, their JavaScript components and what data they use.

To define the UI components used on a page, you can use browser built-in developer tools, or install additionally a plugin, for example Knockoutjs context debugger for Google Chrome.

Debugging using Knockout.js plugin

To install the knockout debugging plugin for Google Chrome, take the following steps:

  1. Open your Google Chrome browser.
  2. Expand Google Chrome options drop-down (hamburger in upper right).
  3. Select Settings.
  4. In left pane, select Extensions.
  5. Scroll to end of the page and click Get more extensions link.
  6. In the Search field write Knockoutjs context debugger and press the Enter key.
  7. In the result, find the extension named Knockoutjs context debugger (usually the first result), and click Add to Chrome.

To define the UI component using the plugin:

  1. Open the required page in Chrome.
  2. Point to the required element on the page, right-click and select Inspect. The developer tools panel opens.
  3. In the right column of the panel, click the Knockout context tab. The tab displays the name and the configuration of the UI component instance.

A simple example:

  1. Launch Magento Admin .
  2. Navigate to Products > Catalog and click Add Product. The product creation page opens.
  3. Right-click on the Product Name field and click Inspect. Go to the Knockout context tab. Here you can see the full context of the field, where you can find JS component file, component name, etc. Image Example

Debugging using pure Knockout

To retrieve the context within markup, you can also use the instance of Knockout:

At first we need to get a Knockout instance from the browser console. To do so, use the RequireJS ID knockout.

var ko = require('knockout');

Now we have Knockout instance in the ko variable. We can use it to get a context of any DOM element.

var context = ko.contextFor($0);

, where $0 is a special variable in browser console. It contains a link to a DOM element that is last inspected.

For example:

// Admin > Products > Catalog > Add Product
// Inspect "Product Name"
var fieldName = ko.contextFor($0).$data;

console.log(fieldName.name); // product_form.product_form.product-details.container_name.name

See also

Debug using uiRegistry