goldendict-ng/website/docs/howto/how to debug dictionary js.md
shenleban tongying 587f48c6b3
Some checks are pending
SonarCloud / Build and analyze (push) Waiting to run
deploy_website / deploy (push) Waiting to run
update docs
2024-10-23 22:49:11 +00:00

1.6 KiB

background

When some js functions do not work as expected, this article tries to give a debug solution to pinpoint the problem.

Web inspector (DevTools)

GoldenDict-ng has embedded an inspector, which is actually chromium's DevTools. You can trigger it manually using F12.

Screenshot: Inspector

Navigate to the specified element

Click the find element and move mouse to the specified element, click the element will navigate the source panel to the very place. steps

Modify the css style

you can play around with the css to modify the appearance of the html and check the results.

style

Check javascript events

  • navigate to the specified element
  • check eventlisterner panel
  • pay attention to the click events
  • in the following screenshot ,there are two registered event listeners, one from the goldendict gd-custom.js and one from the html itself.
  • click the above event listener location will locate to the right place in the javascript.

event

If some desired event does not triggered , it can first check does the event listeners has been successfully registered. then set a breakpoint in the right place to check whether the event has been triggered and if it can executed successfully. breakpoint

Reproduce the issues

following your normal operations and debugging the javascript code and pay attention to the console output. Whether any errors happened. Alt text