5 Commits

Author SHA1 Message Date
Jacob Nguyen
daabc51b93 b 2025-01-12 22:43:16 -06:00
Jacob Nguyen
3abe33b75d fk 2025-01-12 22:37:09 -06:00
Jacob Nguyen
cafecdc532 polish 2025-01-12 22:32:05 -06:00
Jacob Nguyen
b4284e4d1a errrefguide 2025-01-12 22:25:50 -06:00
Jacob Nguyen
21f70725bb Merge pull request #75 from sern-handler/jacoobes-patch-1
Update setup.ts
2025-01-12 21:53:32 -06:00
2 changed files with 60 additions and 1 deletions

View File

@@ -2,7 +2,7 @@
title: Conclusion
description: Thank you for reading the sern guide
sidebar:
order: 9
order: 10
---
If you reached this far, thank you for reading!

View File

@@ -0,0 +1,59 @@
---
title: Error handling
description: Properly handle unexpected errors.
sidebar:
order: 9
---
Error handling is important in any application, especially one which has a long lifetime of running.
## Handling errors in command and event modules
To capture errors, enable the 'error' event in sern's global event manager.
import { FileTree } from '@astrojs/starlight/components';
<FileTree>
- src/
- commands/
- events/
- **error.js**
- index.js
- config.js
- dependencies.d.ts
</FileTree>
:::tip
Don't forget to enable event handling!
```js title='src/config.js'
export const events = "./dist/events"
```
:::
```js
import { EventType, eventModule } from '@sern/handler'
export default eventModule({
type: EventType.Sern,
name: 'error',
execute: (err) => {
console.log('caught', err)
}
})
```
If the error handler is not set, sern's behavior is to crash the application.
This respects [node.js's default behavior](https://nodejs.org/api/events.html#error-events)
:::caution
Be careful about errors thrown IN the error handler.
If this happens, a memory leaks occurs and your bot **will crash**.
:::