# Events

| Event            | Callback Arguments              | About                                                                                                  |
| ---------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------ |
| start            | Directory path & file extension | Fires when Dubnium is initialized.                                                                     |
| create           | Tag & content                   | Fires when a Record is created.                                                                        |
| delete           | Tag & content                   | Fires when a Record is deleted.                                                                        |
| edit             | Tag, old & new content          | Fires when a Record's value changes.                                                                   |
| retagged         | Old & new tag                   | Fires when a Record's tag changes.                                                                     |
| wipe             | Directory path                  | Fires when the database is wiped.                                                                      |
| close            | Directory path                  | Fires when the database is closed.                                                                     |
| delete\_old      | Options                         | Fires when `deleteOld` is called. (Will also fire `delete` for any Records deleted)                    |
| dir              | Directroy path                  | Fires when the directory is created.                                                                   |
| move             | Tag, old & new directory        | Fires when a Record is moved.                                                                          |
| clone            | Tag, target                     | Fires when a Record is cloned.                                                                         |
| symlink          | Tag & path to symlink           | Fires when a Symlink is created.                                                                       |
| sync             | Tag & tag of synced with        | Fires when `syncWith` is called.                                                                       |
| delete\_large    | Options                         | Fires when [`deleteLarge()`](https://db.coolstone.dev/3/api/manage#delete-large-records) is called.    |
| append           | Tag, content                    | Fires when content is appended.                                                                        |
| truncate         | Tag, length                     | Fires when a Record is truncated.                                                                      |
| fs               | Function, tag, args             | Fires when [`fs()`](https://db.coolstone.dev/3/api/miscellaneous#fs) is called.                        |
| beautify         | Tag, replacer, space            | Fires when JSON is beautified.                                                                         |
| exec             | Command & callback              | Fires when a bash command is ran via [`db.exec()`](https://db.coolstone.dev/3/api/miscellaneous#bash). |
| save             | Tag & content                   | Fires when a record is saved. This will also fire the `edit` event.                                    |
| stop\_versioning | Options                         | Fires when you stop recording versions.                                                                |
| empty            | Record tag                      | Fires when a Record is emptied.                                                                        |

{% hint style="info" %}
Any events from `fs.watch()` will be fired if [versioning](https://db.coolstone.dev/3/api/versioning) is enabled.
{% endhint %}

### Example

{% code lineNumbers="true" %}

```javascript
db.on('create', (tag, content) => { console.log(`${tag} was created!`) })
```

{% endcode %}
