Nim for TypeScript developers - async edition

[jonahsnider]

Summary

This is a documentation only issue.

The Nim for TypeScript Programmers is great but is currently missing information about the similarities between Nim's Futures and TypeScript/JavaScript's Promises, as well as how asynchronous functions behave.

Description

Here is a table I've compiled of Nim asyncfutures features and their respective JavaScript counterparts:

Nim	TypeScript/JavaScript
Future[T]	Promise<T>
newFuture[T]	new Promise<T>()
complete	Promise.resolve()
fail	Promise.reject()
addCallback	Promise.prototype.then()
`and`	Promise.all()
`or`	Promise.race()
all	Promise.all()

Additional Information

The above information only mentions Promises, not any of the behavior with asynchronous functions, which do not behave identically to functions that return a Promise. I don't know enough about Nim's async pragma to write about that.

[bung87]

hi , if you targeting js you need compare to asyncjs module, it has subset interfaces of asyncfuture, and doesn't support chained promise.that's the major differiences I've found.

[dom96]

It's a wiki, feel free to modify it :)

[narimiran]

@bung87 @pizzafox interested in making those changes in the wiki? Or maybe @juancarlospaco?

[jonahsnider]

I'm not really comfortable enough with Nim confidently write that kind of documentation. I am however very knowledgeable in TypeScript and would be happy to give more advice on that side of things.