diff --git a/docs/blackboxing-files/blackboxing-call-stack.png b/docs/blackboxing-files/blackboxing-call-stack.png index 127bc19..cdca1fe 100755 Binary files a/docs/blackboxing-files/blackboxing-call-stack.png and b/docs/blackboxing-files/blackboxing-call-stack.png differ diff --git a/docs/blackboxing-files/blackboxing-nav-menu.png b/docs/blackboxing-files/blackboxing-nav-menu.png index d2e2bab..b2142a0 100755 Binary files a/docs/blackboxing-files/blackboxing-nav-menu.png and b/docs/blackboxing-files/blackboxing-nav-menu.png differ diff --git a/docs/blackboxing-files/blackboxing-stack-expanded.png b/docs/blackboxing-files/blackboxing-stack-expanded.png index 93b9da1..a84954b 100755 Binary files a/docs/blackboxing-files/blackboxing-stack-expanded.png and b/docs/blackboxing-files/blackboxing-stack-expanded.png differ diff --git a/docs/blackboxing-files/blackboxing-text-menu.png b/docs/blackboxing-files/blackboxing-text-menu.png index 2a4902e..8ad3898 100755 Binary files a/docs/blackboxing-files/blackboxing-text-menu.png and b/docs/blackboxing-files/blackboxing-text-menu.png differ diff --git a/docs/blackboxing.html b/docs/blackboxing.html index 4d2ecab..87f937d 100644 --- a/docs/blackboxing.html +++ b/docs/blackboxing.html @@ -19,6 +19,8 @@
The screenshot above shows that app.js was opened, where a breakpoint was set. When stepping into that code, backbone.js was opened, then underscore.js. This can be a time consuming process and an undesirable one, too.
+
+

How to blackbox scripts

There are two ways you can add scripts to the blackbox blacklist:

@@ -27,6 +29,8 @@
  • Right-clicking on any script in the Sources panel
    • +

    Settings panel

    +

    To configure blackboxing of scripts in the Settings panel open the DevTools Settings and under Sources click Manage framework blackboxing.

    @@ -37,10 +41,12 @@

    You may want to temporarily unblackbox a rule for testing purposes. You can do this by changing the behavior to Disabled. If you wanted to remove a rule entirely you can click X to delete it.

    +

    Context menus

    +

    In addition to using the Settings panel for adding files to the blacklist, you can use the context menu when working in the Sources panel. You can either right-click on a file in the file navigator or when viewing a file you can right-click in the editor and choose Blackbox Script. This will add the file to the list in the Settings panel.

    - +  
    @@ -51,11 +57,13 @@

    When paused on a breakpoint, in the call stack you will see a message stating there are x number of frames which are blackboxed. You can show these frames if you want, but since they are calls made from a blackboxed script they are hidden unless you click show.

    - +  
    -

    So what happens when a script is blackboxed?

    +
    +
    +

    What happens when a script is blackboxed?

    +

    Conclusion

    To sum things up, while debugging your application code blackboxing the third-party libraries and other scripts which you are not actively developing can help increase your productivity and help keep your focus on the code you really care about. It is easy to enable using any workflow and just as easy to disable if the need to do so arises.

    We want to make sure your debugging experience when working with JS frameworks is excellent. Please file a ticket after trying blackboxing if you have ideas on how it can be improved or address your use cases better.

    +
    {{/partials.standard_devtools_article}} diff --git a/docs/javascript-debugging.html b/docs/javascript-debugging.html index f514db6..a9e68cb 100644 --- a/docs/javascript-debugging.html +++ b/docs/javascript-debugging.html @@ -651,6 +651,7 @@ abstractions.

    Read more