Docs: more explanation for page.evaluateHandle()

[ebidel]

#1003 (comment) mentioned that page.evaluateHandle() can be used to run code in the context of the page, but in a "clean room" environment (e.g. avoiding issues with pages that override native methods). Is that right?

The docs are fuzzy about page.evaluateHandle() being a next context. It mentions an alias to executionContext but I think more info on why you'd use either would be good.

[aslushnikov]

can be used to run code in the context of the page, but in a "clean room" environment (e.g. avoiding issues with pages that override native methods). Is that right?

No, the only difference between evaluate and evaluateHandle is that the former returns a javascript-object, and the latter returns a reference to the in-page object aka JSHandle.

Anybody is welcome to improve docs, we'll be happy to review a PR!

[yelisaveta]

Hi @aslushnikov, I have raised a PR for this issue, please see: #1867

I will be happy to make a PR for this issue as well: #1051

This is my first contribution to open-source project so I am open to any help/advice to my PR. Thanks!

[yanivefraim]

@yelisaveta - are you on #1051? If not, I would like to take it (:

[yelisaveta]

@yanivefraim no I am not, feel free to take it!

[yanivefraim]

@aslushnikov - I believe this was fixed by #1867? (it didn't have 'fixes ...' so no reference to PR here)

[aslushnikov]

@yanivefraim you're right, thanks