Files
palemoon27/dom/webidl/HeapSnapshot.webidl
T
roytam1 994061d746 import changes from `dev' branch of rmottola/Arctic-Fox:
- Bug 1196631 - Make JS::ubi::Node::size return 1 by default. r=sfink (9b34eb8a6b)
- Bug 1191236 - Remove extract() methods used by operation forwarding on rooting types r=terrence (fb73375f55)
- Bug 1191236 - Fix UCS canonicalization, r=jonco (fb5f57c838)
- Bug 1196498 - Include objects' [[class]] names in heap snapshots; r=sfink (563e562e95)
- Bug 1194418 - Use only JS::ubi::* interfaces in census analyses; r=sfink (a1374c3a49)
- Bug 1194422 - Expose census traversals to SpiderMonkey embedders; r=sfink (7cd731fffc)
- Bug 1139476 - Part 0: Add a takeCensus method to HeapSnapshot instances; r=sfink,bholley (6aac2ae0dd)
- Bug 1139476 - Part 1: Port live heap census tests to offline heap snapshots; r=sfink (2cd8e13492)
- Bug 1139476 - Part 2: Add test comparing live and offline census results; r=sfink (0db23ac1a0)
-  Bg 1198980 - Make JS::ubi::*::identifier be uint64_t instead of uintptr_t. r=sfink (902c041cb0)
- Bug 1196634 - Part 0: Define a JS::ubi::CoarseType enum; r=sfink (4606fc2845)
- Bug 1196634 - Part 1: Extend the protobuf format for coarseType; r=sfink (4110d46a2f)
- Bug 1196634 - Part 2: Serialize and deserialize coarseType; r=sfink (530e023b48)
- Bug 1196634 - Part 3: Use coarseType() instead of is<T> in census; r=sfink (d077980d77)
- Bug 1196634 - Part 4: Remove JS::ubi::Node::getCanonicalTypeName; r=sfink (4bd7131e4b)
- Bug 1202048 - Root JSONParser explicitly; r=sfink (41a9034849)
- Bug 1175523 - Update most (but not all) tests to use elem.srcObject over .mozSrcObject. r=pehrsons (22a6502d6d)
- Bug 1201190 - Part 3: Mark every consumer of GUARD_OBJECT as MOZ_RAII, r=ehsan (f6c6381a15)
- Bug 1204594 - Use MOZ_RAII to replace GUARD_OBJECT where possible in the GC; r=sfink (cec9b7f607)
- Bug 1205054 - Remove isNullLike and other imprecise null checks; r=sfink (c12a6ed1d4)
- Bug 1205454 - Consolidate the tagged pointer marking methods; r=sfink (7e8a823712)
- js: more shared-build fixes (fdd3b957)
2022-08-08 11:07:50 +08:00

54 lines
2.0 KiB
Plaintext

/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
* You can obtain one at http://mozilla.org/MPL/2.0/.
*/
/**
* A HeapSnapshot represents a snapshot of the heap graph
*/
[ChromeOnly, Exposed=(Window,System,Worker)]
interface HeapSnapshot {
/**
* Take a census of the heap snapshot.
*
* This is the same as |Debugger.Memory.prototype.takeCensus|, but operates on
* the offline heap snapshot's serialized heap graph rather than the live heap
* graph. The same optional configuration options that can be passed to that
* function can be passed here.
*
* The returned value is determined by the `"breakdown"` option used, and is
* usually a `Map`, `Object`, or `Array`. For example, the following breakdown
*
* {
* by: "coarseType",
* objects: { by: "objectClass" },
* other: { by: "internalType" }
* }
*
* produces a result like this:
*
* {
* "objects": {
* "Function": { "count": 404, "bytes": 37328 },
* "Object": { "count": 11, "bytes": 1264 },
* "Debugger": { "count": 1, "bytes": 416 },
* "ScriptSource": { "count": 1, "bytes": 64 },
* // ... omitted for brevity...
* },
* "scripts": { "count": 1, "bytes": 0 },
* "strings": { "count": 701, "bytes": 49080 },
* "other": {
* "js::Shape": { "count": 450, "bytes": 0 },
* "js::BaseShape": { "count": 21, "bytes": 0 },
* "js::ObjectGroup": { "count": 17, "bytes": 0 }
* }
* }
*
* See the `takeCensus` section of the `js/src/doc/Debugger/Debugger.Memory.md`
* file for detailed documentation.
*/
[Throws]
any takeCensus(object? options);
};