[Documentation] On process.stdout.cursorTo

[binarykitchen]

It seems that there is no API documentation on process.stdout.cursorTo. Or it was too difficult for me to find any.

Also, is there a function to query the current cursor position? No idea. Thx!

[indutny]

Not exactly what you asked for, but anyway should be fixed by #6948

[binarykitchen]

@indutny Easy. Let me ask you: Where is cursorTo() documented? Been searching everywhere in the node.js API docu but failed.

[indutny]

Have you seen #6948 that I mentioned in previous message ;)

[binarykitchen]

Oh sorry. Missed out that commit. Great! No further questions.

[dcposch]

I think this is still an issue.

The readline module is not the same thing! It has its own function called cursorTo with different arguments.

I googled and can't find any documentation on process.stdout.cursorTo. However, in recent Node (v6.4.0), the following works:

var i = 0
setInterval(function () {
  process.stdout.write('test ' + (i++))
  process.stdout.cursorTo(0)
}, 1000)

In case process.std[out,err].cursorTo() and .clearLine() are deprecated and we're supposed to use readline now, then the docs should at least say that.

Here's an example of one popular module, node-progress, that still uses process.stdout.cursorTo: https://github.com/visionmedia/node-progress/blob/master/lib/node-progress.js#L195