Coment about setTimeout mentioned in the documentation.

[stroiman]

In the documentation, it states

Where is setTimeout()?

setTimeout() assumes concurrent execution of code which requires an execution environment, for example an event loop similar to nodejs or a browser. There is a separate project aimed at providing some NodeJS functionality, and it includes an event loop.

I find the text misleading, becuase there is a much more important reason why setTimeout and friends shouldn't be in a library like goja: They are not part of the ECMAScript specification

Both a browser and node.js have implementations that are similar, but not identical interface. In a browser, the returned handle is a number. In node.js, it's an instance of a Timeout class.

So that is the reason why they shouldn't exist, and they don't exist in v8 either. (I don't know how it is for SpiderMonkey)

The fact that there's another library for node.js behaviour is amazing, and absolutely the right way to go about this. I'd gladly provide a PR with a rewrite this part of the readme, if you think it makes sense.

[dop251]

You are right, this is another reason and it is probably more important than the one mentioned. I still think it's worth mentioning them both, will be happy to review a PR.