diff options
-rw-r--r-- | docs/api.md | 44 |
1 files changed, 29 insertions, 15 deletions
diff --git a/docs/api.md b/docs/api.md index fa7803a..b745d94 100644 --- a/docs/api.md +++ b/docs/api.md @@ -352,21 +352,6 @@ listen to this event, but it may aid in debugging. Emitted when the torrent encounters a fatal error. The torrent is automatically destroyed and removed from the client when this occurs. -## `torrent.on('infoHash', function () {})` - -Emitted when the info hash of the torrent has been determined. - -## `torrent.on('metadata', function () {})` - -Emitted when the metadata of the torrent has been determined. This includes the full -contents of the .torrent file, including list of files, torrent length, piece hashes, -piece length, etc. - -## `torrent.on('ready', function () {})` - -Emitted when the torrent is ready to be used (i.e. metadata is available and store is -ready). - ## `torrent.on('done', function () {})` Emitted when all the torrent files have been downloaded. @@ -396,6 +381,20 @@ torrent.on('download', function(chunkSize){ }) ``` +## `torrent.on('upload', function (chunkSize) {})` + +Emitted every time a new chunk of data is sent, it's useful for reporting the current torrent status, for instance: + +```js +torrent.on('uploaded', function(chunkSize){ + console.log('chunk size: ' + chunkSize); + console.log('total uploaded: ' + torrent.uploaded); + console.log('upload speed: ' + torrent.uploadSpeed); + console.log('progress: ' + torrent.progress); + console.log('======'); +}) +``` + ## `torrent.on('wire', function (wire) {})` Emitted whenever a new peer is connected for this torrent. `wire` is an instance of @@ -418,6 +417,21 @@ See the `bittorrent-protocol` [extension api docs](https://github.com/feross/bittorrent-protocol#extension-api) for more information on how to define a protocol extension. +## `torrent.on('infoHash', function () {})` + +Emitted when the info hash of the torrent has been determined. + +## `torrent.on('metadata', function () {})` + +Emitted when the metadata of the torrent has been determined. This includes the full +contents of the .torrent file, including list of files, torrent length, piece hashes, +piece length, etc. + +## `torrent.on('ready', function () {})` + +Emitted when the torrent is ready to be used (i.e. metadata is available and store is +ready). + # File API ## `file.name` |