goldendict-ng/website/docs/howto/how to debug dictionary js.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

41 lines
1.6 KiB
Markdown
Raw Permalink Normal View History

2023-08-30 08:19:24 +00:00
## background
2023-08-30 03:11:42 +00:00
When some js functions do not work as expected, this article tries to give a debug solution to pinpoint the problem.
2024-10-23 22:49:11 +00:00
## Web inspector (DevTools)
2023-08-30 03:11:42 +00:00
2024-10-23 22:49:11 +00:00
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`.
2023-08-30 03:11:42 +00:00
Screenshot:
![Inspector](../img/inspector.png)
2024-10-23 22:49:11 +00:00
## Navigate to the specified element
2023-08-30 03:11:42 +00:00
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)
2023-08-30 08:19:24 +00:00
## Modify the css style
2023-08-30 03:11:42 +00:00
you can play around with the css to modify the appearance of the html and check the results.
![style](../img/inspector-style.png)
2024-10-23 22:49:11 +00:00
## Check javascript events
2023-08-30 03:11:42 +00:00
- 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)
2024-10-23 22:49:11 +00:00
## Reproduce the issues
2023-08-30 03:11:42 +00:00
following your normal operations and debugging the javascript code and pay attention to the console output. Whether any errors happened.
2023-08-30 08:19:24 +00:00
![Alt text](../img/inspector-console.png)