saleor-app-sdk-REDIS_APL/docs/debugging.md
Lukasz Ostrowski 191f12a87d
Add docs about debugging (#37)
* Add CODEOWNERS

* Add doc for debug

* Update readme

* Update readme

* Update docs/debugging.md

Co-authored-by: Adrian Pilarczyk <adrianpilarczyk314@gmail.com>

* Update docs/debugging.md

Co-authored-by: Adrian Pilarczyk <adrianpilarczyk314@gmail.com>

* Update docs/debugging.md

Co-authored-by: Adrian Pilarczyk <adrianpilarczyk314@gmail.com>

* Apply suggestions from code review

Co-authored-by: Adrian Pilarczyk <adrianpilarczyk314@gmail.com>

* Add info about debug in iframe

Co-authored-by: Adrian Pilarczyk <adrianpilarczyk314@gmail.com>
2022-08-30 11:53:21 +02:00

1.5 KiB

Debugging

The ability to debug is important for app developers. App SDK provides opt-in verbose logs, that can be enabled for specific modules.

Debug logs are implemented with debug package and work both in Node and Browser.

Enabling verbose logs

Debug logs are aggregated within namespaces. They can be enabled, disabled, or configured.

By default, all verbose logs are disabled.

To enable logs, use the following:

Enabling in Node context

Add DEBUG={namespaces} env variable.

Example

DEBUG=* pnpm run dev

For more details check debug package.

Enabling in Browser context

Set localStorage.debug = '{namepsaces}' in your frontend code. For more details see debug package.

Debug in iframe

Note, that Saleor Apps are usually hosted on a different domain than Saleor Dashboard. That means localStorage must be called in the context of the App's URL, not Saleor Dashboard.

Example

// In devtools console
localStorage.debug = "*";

Namespaces

Use the namespace name to enable debug logs for each module.

Namespace name Description
* Enable all
AppBridge Enable AppBridge (browser only)