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

41 lines
1.6 KiB
Markdown

## 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](https://developer.chrome.com/docs/devtools). You can trigger it manually using `F12`.
Screenshot:
![Inspector](../img/inspector.png)
## 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](../img/inspector-steps.png)
## Modify the css style
you can play around with the css to modify the appearance of the html and check the results.
![style](../img/inspector-style.png)
## 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](../img/inspector-event.png)
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](../img/inspector-breakpoint.png)
## 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](../img/inspector-console.png)