Debugging a Web App

The webOS TV SDK provides Web Inspector and Node Inspector for debugging web applications and JS Services. You can monitor the execution information of web applications or JS Services running on the target device with Web Inspector and Node Inspector. For this, you need to create a package file (.ipk) without minifying. This section describes how to create a package file and execute Web Inspector and Node Inspector for debugging.

Packaging a Web App for Debugging

For Enyo web application, ares-package command reduces and merges the source code when creating the package file (.ipk). ares-package command adjusts and shrinks variable names and line spacing. It also merges multiple files into a single file to reduce the source code size and file loading time. You may use other scripts to minify non-Enyo web application. However, these minifying jobs make debugging difficult.

For this reason, you should not carelessly reduce and merge the source code to debug web applications and JS services. It becomes difficult to check the information if the source code is reduced or the files are merged. Do not run the minifying task, using the --no-minify option for Enyo web application as below. --no-minify option is available only for Enyo web applications.

ares-package --no-minify sampleApp

Creating package com.yourdomain.app_0.0.1_all.ipk in ./
Since the size of the package files for debugging is larger than that of the basic setup files, use the package files for debugging purposes only.

Launching Web Inspector

The ares-inspect command provides the Web Inspector for debugging web applications. The running information of web application is displayed through the Web Inspector.

Execute the following command while the web application is running:

ares-inspect --device emulator --app --open

You can use the Web Inspector as below:


The Web Inspector is based on Google Chrome Developer Tools. Refer to the Google Developers for the detailed description of how to use Google Chrome Developer Tools.  Some versions of Google Chrome may not support the Web Inspector. For more information, refer to FAQ.

Launching Node Inspector

The ares-inspect command provides the Node Inspector for debugging JS services. The running information of JS service is displayed through the Node Inspector.

Execute the following command while the JS service is working:

ares-inspect --device emulator --service --open

You can use the Node Inspector as below:


For more information about the Node Inspector, refer to the GitHub of Node Inspector.

Testing a Local App

The ares-server command can run web server based on app source directory. The web browser has some restrictions related to security policy, on accessing local files (Same-origin policy). For this reason, this script provides a simple web server to avoid security policy of browsers.

Execute the command to start a web server on your app source directory. You can open your app with the given URL.

ares-server ./source


Local server running on http://localhost:7496

If you want to open with a bundled browser (Chromium) directly, use --open option as below:

ares-server ./source --open
To terminate the web server, use Control-C on prompt.