Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(365)

Issue 1542623004: Add documentation about Isolate, Context, World, Frames etc (Closed)

Created:
5 years ago by haraken
Modified:
4 years, 11 months ago
CC:
blink-reviews, blink-reviews-bindings_chromium.org, chromium-reviews
Base URL:
https://chromium.googlesource.com/chromium/src.git@master
Target Ref:
refs/pending/heads/master
Project:
chromium
Visibility:
Public.

Description

Add documentation about Isolate, Context, World, Frames etc BUG= Committed: https://crrev.com/b6f387262b5241d6eb278604b59a8527e7996ee6 Cr-Commit-Position: refs/heads/master@{#366959}

Patch Set 1 #

Total comments: 8

Patch Set 2 : #

Total comments: 14
Unified diffs Side-by-side diffs Delta from patch set Stats (+259 lines, -0 lines) Patch
A third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md View 1 1 chunk +259 lines, -0 lines 14 comments Download

Messages

Total messages: 13 (4 generated)
haraken
PTAL
5 years ago (2015-12-22 07:04:31 UTC) #2
Yuki
LGTM with comments. https://codereview.chromium.org/1542623004/diff/1/third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md File third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md (right): https://codereview.chromium.org/1542623004/diff/1/third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md#newcode102 third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md:102: When V8 binding invokes JavaScript, V8 ...
5 years ago (2015-12-24 07:15:15 UTC) #3
haraken
https://codereview.chromium.org/1542623004/diff/1/third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md File third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md (right): https://codereview.chromium.org/1542623004/diff/1/third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md#newcode102 third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md:102: When V8 binding invokes JavaScript, V8 binding creates a ...
4 years, 12 months ago (2015-12-28 02:55:00 UTC) #6
commit-bot: I haz the power
CQ is trying da patch. Follow status at https://chromium-cq-status.appspot.com/patch-status/1542623004/20001 View timeline at https://chromium-cq-status.appspot.com/patch-timeline/1542623004/20001
4 years, 12 months ago (2015-12-28 02:55:00 UTC) #7
commit-bot: I haz the power
Committed patchset #2 (id:20001)
4 years, 12 months ago (2015-12-28 03:53:08 UTC) #8
commit-bot: I haz the power
Failed to apply the patch.
4 years, 12 months ago (2015-12-28 03:53:24 UTC) #9
commit-bot: I haz the power
Patchset 2 (id:??) landed as https://crrev.com/b6f387262b5241d6eb278604b59a8527e7996ee6 Cr-Commit-Position: refs/heads/master@{#366959}
4 years, 12 months ago (2015-12-28 03:54:07 UTC) #11
jochen (gone - plz use gerrit)
https://codereview.chromium.org/1542623004/diff/20001/third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md File third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md (right): https://codereview.chromium.org/1542623004/diff/20001/third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md#newcode11 third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md:11: An isolate is a concept of a thread in ...
4 years, 11 months ago (2016-01-07 10:18:45 UTC) #12
haraken
4 years, 11 months ago (2016-01-08 05:22:34 UTC) #13
Message was sent while issue was closed.
Uploaded a CL to apply jochen's comments:
https://codereview.chromium.org/1567103003/

https://codereview.chromium.org/1542623004/diff/20001/third_party/WebKit/Sour...
File third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md (right):

https://codereview.chromium.org/1542623004/diff/20001/third_party/WebKit/Sour...
third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md:11: An isolate is
a concept of a thread in V8.
On 2016/01/07 10:18:44, jochen wrote:
> that's not really true, it's just the way Blink uses V8

Reworded.

https://codereview.chromium.org/1542623004/diff/20001/third_party/WebKit/Sour...
third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md:68: the callee
function is pushed onto the stack. When that function returns,
On 2016/01/07 10:18:45, jochen wrote:
> that's not true in general (e.g. tail calls don't do that)

I don't want to run into that kind of details since this document is written for
developers who are not familiar with isolate, context, world etc...

https://codereview.chromium.org/1542623004/diff/20001/third_party/WebKit/Sour...
third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md:73: of the stack)
a current context.
On 2016/01/07 10:18:44, jochen wrote:
> unless the debugger is active, then the top context might also be the debugger
> context :-/

Added the explanation for a debugger context.

https://codereview.chromium.org/1542623004/diff/20001/third_party/WebKit/Sour...
third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md:111: context an
entered context.
On 2016/01/07 10:18:45, jochen wrote:
> any V8 C++ API that takes a context argument enters that context.

Added.

https://codereview.chromium.org/1542623004/diff/20001/third_party/WebKit/Sour...
third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md:136: An isolate of
a worker thread has 1 worker world and 0 isolated world.
On 2016/01/07 10:18:44, jochen wrote:
> is that also true for compositor workers?

This description is true, but it is not true that one isolate maps to one
compositor worker thread. Updated the explanation of the isolate.

https://codereview.chromium.org/1542623004/diff/20001/third_party/WebKit/Sour...
third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md:140: All worlds in
one isolate share underlying C++ DOM objects,
On 2016/01/07 10:18:45, jochen wrote:
> for one specific iframe that is

What do you mean?

https://codereview.chromium.org/1542623004/diff/20001/third_party/WebKit/Sour...
third_party/WebKit/Source/bindings/core/v8/V8BindingDesign.md:196: For
compatibility reasons (although this is not speced),
On 2016/01/07 10:18:45, jochen wrote:
> At least some specs explicitly state this

Removed the words in the parentheses.

Powered by Google App Engine
This is Rietveld 408576698