@memlab/api 1.0.1 → 1.0.4

package/dist/__tests__/API/E2EResultReader.test.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable @typescript-eslint/ban-ts-comment */
+const fs_1 = __importDefault(require("fs"));
+const BrowserInteractionResultReader_1 = __importDefault(require("../../result-reader/BrowserInteractionResultReader"));
+const index_1 = require("../../index");
+const E2ETestSettings_1 = require("./lib/E2ETestSettings");
+beforeEach(E2ETestSettings_1.testSetup);
+function inject() {
+    // @ts-ignore
+    window.injectHookForLink4 = () => {
+        const arr = [];
+        for (let i = 0; i < 10000; ++i) {
+            arr.push('duplicated string value' + (i % 1));
+        }
+        // @ts-ignore
+        window.__injectedValue = arr;
+    };
+}
+function checkResultReader(result) {
+    const workDir = result.getRootDirectory();
+    expect(fs_1.default.existsSync(workDir)).toBe(true);
+    const snapshotDir = result.getSnapshotFileDir();
+    expect(fs_1.default.existsSync(snapshotDir)).toBe(true);
+    const snapshotFiles = result.getSnapshotFiles();
+    expect(snapshotFiles.length > 0).toBe(true);
+    const steps = result.getInteractionSteps();
+    expect(steps.length > 0).toBe(true);
+    expect(steps[0].name).toBe('page-load');
+    const runMeta = result.getRunMetaInfo();
+    expect(runMeta.app).toBe('test-spa');
+    result.cleanup();
+    expect(fs_1.default.existsSync(workDir)).toBe(false);
+    expect(() => result.getRootDirectory()).toThrowError();
+    expect(() => result.getSnapshotFileDir()).toThrowError();
+    expect(() => result.getSnapshotFiles()).toThrowError();
+}
+test('result data/file reader is working as expected', () => __awaiter(void 0, void 0, void 0, function* () {
+    const result = yield (0, index_1.warmupAndTakeSnapshots)({
+        scenario: E2ETestSettings_1.scenario,
+        evalInBrowserAfterInitLoad: inject,
+    });
+    checkResultReader(result);
+}), E2ETestSettings_1.testTimeout);
+test('ResultReader.from is working as expected', () => __awaiter(void 0, void 0, void 0, function* () {
+    const result = yield (0, index_1.warmupAndTakeSnapshots)({
+        scenario: E2ETestSettings_1.scenario,
+        evalInBrowserAfterInitLoad: inject,
+    });
+    checkResultReader(BrowserInteractionResultReader_1.default.from(result.getRootDirectory()));
+}), E2ETestSettings_1.testTimeout);

package/dist/__tests__/API/E2ERunSingleSnapshot.example.js

@@ -17,22 +17,21 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const path_1 = __importDefault(require("path"));
 const index_1 = require("../../index");
 const scenario = {
     app: () => 'test-spa',
     url: () => '',
     action: (page) => __awaiter(void 0, void 0, void 0, function* () { return yield page.click('[data-testid="link-4"]'); }),
 };
-const promise = (0, index_1.run)({
-    scenario,
-});
-promise.then(result => {
-    const analysis = new index_1.StringAnalysis();
-    const snapshotFile = path_1.default.join(result.config.curDataDir, 's3.heapsnapshot');
-    analysis.analyzeSnapshotFromFile(snapshotFile);
-});
+function test() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const result = yield (0, index_1.warmupAndTakeSnapshots)({
+            scenario,
+        });
+        const analysis = new index_1.StringAnalysis();
+        const snapshotFile = result.getSnapshotFiles().pop();
+        analysis.analyzeSnapshotFromFile(snapshotFile);
+    });
+}
+test();

package/dist/__tests__/API/E2EShapeUnboundGrowthAnalysis.test.js

@@ -17,12 +17,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 /* eslint-disable @typescript-eslint/ban-ts-comment */
-const path_1 = __importDefault(require("path"));
 const index_1 = require("../../index");
 const E2ETestSettings_1 = require("./lib/E2ETestSettings");
 beforeEach(E2ETestSettings_1.testSetup);
@@ -44,29 +40,24 @@ function inject() {
 test('Shape unbound analysis works as expected', () => __awaiter(void 0, void 0, void 0, function* () {
     const repeatScenario = Object.assign({ repeat: () => 2 }, E2ETestSettings_1.scenario);
     // test analysis from auto loading
-    const result = yield (0, index_1.run)({
+    const result = yield (0, index_1.warmupAndTakeSnapshots)({
         scenario: repeatScenario,
         evalInBrowserAfterInitLoad: inject,
         snapshotForEachStep: true,
     });
     // test analysis from auto loading
     let analysis = new index_1.ShapeUnboundGrowthAnalysis();
-    let shapeSummary = yield analysis.run();
+    yield analysis.run();
+    let shapeSummary = analysis.getShapesWithUnboundGrowth();
     expect(shapeSummary.reduce((acc, summary) => acc || summary.shape.includes('LeakObject'), false)).toBe(true);
     // test analysis from file
-    const snapshotDir = path_1.default.join(result.config.curDataDir);
+    const snapshotDir = result.getSnapshotFileDir();
     analysis = new index_1.ShapeUnboundGrowthAnalysis();
-    shapeSummary = yield analysis.analyzeSnapshotsInDirectory(snapshotDir);
+    yield analysis.analyzeSnapshotsInDirectory(snapshotDir);
+    shapeSummary = analysis.getShapesWithUnboundGrowth();
     expect(shapeSummary.some((summary) => summary.shape.includes('LeakObject'))).toBe(true);
     // expect incorrect use of heap analysis to throw
-    const snapshotFile = path_1.default.join(result.config.curDataDir, 's3.heapsnapshot');
+    const snapshotFile = result.getSnapshotFiles().pop();
     analysis = new index_1.ShapeUnboundGrowthAnalysis();
-    let isThrow = false;
-    try {
-        yield analysis.analyzeSnapshotFromFile(snapshotFile);
-    }
-    catch (ex) {
-        isThrow = true;
-    }
-    expect(isThrow).toBe(true);
+    expect(() => __awaiter(void 0, void 0, void 0, function* () { return yield analysis.analyzeSnapshotFromFile(snapshotFile); })).rejects.toThrowError();
 }), E2ETestSettings_1.testTimeout);

package/dist/__tests__/API/E2EStringAnalysis.test.js

@@ -17,12 +17,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 /* eslint-disable @typescript-eslint/ban-ts-comment */
-const path_1 = __importDefault(require("path"));
 const index_1 = require("../../index");
 const E2ETestSettings_1 = require("./lib/E2ETestSettings");
 beforeEach(E2ETestSettings_1.testSetup);
@@ -38,7 +34,10 @@ function inject() {
     };
 }
 test('String analysis works as expected', () => __awaiter(void 0, void 0, void 0, function* () {
-    const result = yield (0, index_1.run)({ scenario: E2ETestSettings_1.scenario, evalInBrowserAfterInitLoad: inject });
+    const result = yield (0, index_1.warmupAndTakeSnapshots)({
+        scenario: E2ETestSettings_1.scenario,
+        evalInBrowserAfterInitLoad: inject,
+    });
     // test analysis from auto loading
     let analysis = new index_1.StringAnalysis();
     yield analysis.run();
@@ -46,21 +45,26 @@ test('String analysis works as expected', () => __awaiter(void 0, void 0, void 0
     expect(dupStrings[0].n).toBe(10000);
     expect(dupStrings[0].str).toBe('duplicated string value0');
     // test analysis from file
-    const snapshotFile = path_1.default.join(result.config.curDataDir, 's3.heapsnapshot');
+    const snapshotFile = result.getSnapshotFiles().pop();
     analysis = new index_1.StringAnalysis();
     yield analysis.analyzeSnapshotFromFile(snapshotFile);
     dupStrings = analysis.getTopDuplicatedStringsInCount();
     expect(dupStrings[0].n).toBe(10000);
     expect(dupStrings[0].str).toBe('duplicated string value0');
     // expect incorrect use of heap analysis to throw
-    const snapshotDir = result.config.curDataDir;
+    const snapshotDir = result.getSnapshotFileDir();
     analysis = new index_1.StringAnalysis();
-    let isThrow = false;
-    try {
-        yield analysis.analyzeSnapshotsInDirectory(snapshotDir);
-    }
-    catch (ex) {
-        isThrow = true;
-    }
-    expect(isThrow).toBe(true);
+    expect(() => __awaiter(void 0, void 0, void 0, function* () { return yield analysis.analyzeSnapshotsInDirectory(snapshotDir); })).rejects.toThrowError();
+}), E2ETestSettings_1.testTimeout);
+test('analyze function works as expected', () => __awaiter(void 0, void 0, void 0, function* () {
+    const result = yield (0, index_1.warmupAndTakeSnapshots)({
+        scenario: E2ETestSettings_1.scenario,
+        evalInBrowserAfterInitLoad: inject,
+    });
+    // test analysis from auto loading
+    const analysis = new index_1.StringAnalysis();
+    yield (0, index_1.analyze)(result, analysis);
+    const dupStrings = analysis.getTopDuplicatedStringsInCount();
+    expect(dupStrings[0].n).toBe(10000);
+    expect(dupStrings[0].str).toBe('duplicated string value0');
 }), E2ETestSettings_1.testTimeout);

package/dist/__tests__/heap/examples/example-1.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+export {};
+//# sourceMappingURL=example-1.d.ts.map

package/dist/__tests__/heap/examples/example-1.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@memlab/core");
+class TestObject {
+    constructor() {
+        this.arr1 = [1, 2, 3];
+        this.arr2 = ['1', '2', '3'];
+    }
+}
+(function () {
+    return __awaiter(this, void 0, void 0, function* () {
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        const obj = new TestObject();
+        // get a heap snapshot of the current program state
+        const heap = yield (0, core_1.getNodeInnocentHeap)();
+        const node = heap.getAnyObjectWithClassName('TestObject');
+        console.log(node === null || node === void 0 ? void 0 : node.name);
+    });
+})();

package/dist/__tests__/heap/examples/example-2.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+export {};
+//# sourceMappingURL=example-2.d.ts.map

package/dist/__tests__/heap/examples/example-2.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@memlab/core");
+const heap_analysis_1 = require("@memlab/heap-analysis");
+(function () {
+    return __awaiter(this, void 0, void 0, function* () {
+        const heapFile = (0, core_1.dumpNodeHeapSnapshot)();
+        const heap = yield (0, heap_analysis_1.getHeapFromFile)(heapFile);
+        // get the total number of heap objects
+        heap.nodes.length;
+        heap.nodes.forEach((node) => {
+            console.log(node.name);
+        });
+    });
+})();

package/dist/__tests__/heap/examples/example-3.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+export {};
+//# sourceMappingURL=example-3.d.ts.map

package/dist/__tests__/heap/examples/example-3.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@memlab/core");
+const heap_analysis_1 = require("@memlab/heap-analysis");
+(function () {
+    return __awaiter(this, void 0, void 0, function* () {
+        const heapFile = (0, core_1.dumpNodeHeapSnapshot)();
+        const heap = yield (0, heap_analysis_1.getHeapFromFile)(heapFile);
+        // get the total number of heap references
+        heap.edges.length;
+        heap.edges.forEach((edge) => {
+            console.log(edge.name_or_index);
+        });
+    });
+})();

package/dist/__tests__/heap/examples/example-4.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+export {};
+//# sourceMappingURL=example-4.d.ts.map

package/dist/__tests__/heap/examples/example-4.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@memlab/core");
+const heap_analysis_1 = require("@memlab/heap-analysis");
+(function () {
+    return __awaiter(this, void 0, void 0, function* () {
+        const heapFile = (0, core_1.dumpNodeHeapSnapshot)();
+        const heap = yield (0, heap_analysis_1.getHeapFromFile)(heapFile);
+        const node = heap.getNodeById(1);
+        if (node) {
+            console.log(node.id);
+        }
+    });
+})();

package/dist/__tests__/heap/examples/example-5.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+export {};
+//# sourceMappingURL=example-5.test.d.ts.map

package/dist/__tests__/heap/examples/example-5.test.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@memlab/core");
+class TestObject {
+    constructor() {
+        this.arr1 = [1, 2, 3];
+        this.arr2 = ['1', '2', '3'];
+    }
+}
+test('memory test', () => __awaiter(void 0, void 0, void 0, function* () {
+    core_1.config.muteConsole = true;
+    let obj = new TestObject();
+    // get a heap snapshot of the current program state
+    let heap = yield (0, core_1.getNodeInnocentHeap)();
+    // call some function that may add references to obj
+    // rabbitHole()
+    expect(heap.hasObjectWithClassName('TestObject')).toBe(true);
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    obj = null;
+    heap = yield (0, core_1.getNodeInnocentHeap)();
+    // if rabbitHole does not add new references, the obj can be GCed
+    expect(heap.hasObjectWithClassName('TestObject')).toBe(false);
+}), 30000);

package/dist/__tests__/heap/examples/example-6.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+export {};
+//# sourceMappingURL=example-6.d.ts.map

package/dist/__tests__/heap/examples/example-6.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@memlab/core");
+const heap_analysis_1 = require("@memlab/heap-analysis");
+(function () {
+    return __awaiter(this, void 0, void 0, function* () {
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        const object = { 'memlab-test-heap-property': 'memlab-test-heap-value' };
+        const heapFile = (0, core_1.dumpNodeHeapSnapshot)();
+        const heap = yield (0, heap_analysis_1.getHeapFromFile)(heapFile);
+        // should be true
+        console.log(heap.hasObjectWithPropertyName('memlab-test-heap-property'));
+    });
+})();

package/dist/__tests__/heap/examples/example-7.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+export {};
+//# sourceMappingURL=example-7.test.d.ts.map

package/dist/__tests__/heap/examples/example-7.test.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@memlab/core");
+test('memory test', () => __awaiter(void 0, void 0, void 0, function* () {
+    core_1.config.muteConsole = true;
+    const o1 = {};
+    let o2 = {};
+    // tag o1 with marker: "memlab-mark-1"
+    (0, core_1.tagObject)(o1, 'memlab-mark-1');
+    // tag o2 with marker: "memlab-mark-2"
+    (0, core_1.tagObject)(o2, 'memlab-mark-2');
+    o2 = null;
+    const heap = yield (0, core_1.getNodeInnocentHeap)();
+    // expect object with marker "memlab-mark-1" exists
+    expect(heap.hasObjectWithTag('memlab-mark-1')).toBe(true);
+    // expect object with marker "memlab-mark-2" can be GCed
+    expect(heap.hasObjectWithTag('memlab-mark-2')).toBe(false);
+}), 30000);

package/dist/__tests__/packages/heap-analysis.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+export {};
+//# sourceMappingURL=heap-analysis.test.d.ts.map

package/dist/__tests__/packages/heap-analysis.test.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const heap_analysis_1 = require("@memlab/heap-analysis");
+const index_1 = require("../../index");
+const E2ETestSettings_1 = require("../API/lib/E2ETestSettings");
+const API_1 = require("../../API");
+beforeEach(E2ETestSettings_1.testSetup);
+function injectTestObject() {
+    class TestObject {
+    }
+    // @ts-ignore
+    window.injectHookForLink4 = () => {
+        // @ts-ignore
+        const arr = (window.__injectedValue = window.__injectedValue || []);
+        arr.push(new TestObject());
+    };
+}
+const selfDefinedScenario = {
+    app: () => 'test-spa',
+    url: () => '',
+    action: (page) => __awaiter(void 0, void 0, void 0, function* () { return yield page.click('[data-testid="link-4"]'); }),
+    repeat: () => 3,
+};
+class ExampleAnalysis extends heap_analysis_1.BaseAnalysis {
+    constructor() {
+        super(...arguments);
+        this.isMonotonicIncreasing = false;
+    }
+    getCommandName() {
+        return 'example-analysis';
+    }
+    getDescription() {
+        return 'an example analysis for demo';
+    }
+    process(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // check if the number of TestObject keeps growing overtime
+            this.isMonotonicIncreasing = yield (0, heap_analysis_1.snapshotMapReduce)(heap => {
+                let cnt = 0;
+                heap.nodes.forEach(node => {
+                    if (node.name === 'TestObject' && node.type === 'object') {
+                        ++cnt;
+                    }
+                });
+                return cnt;
+            }, nodeCounts => nodeCounts[0] === 0 &&
+                nodeCounts[nodeCounts.length - 1] === 4 &&
+                nodeCounts.every((count, i) => i === 0 || count >= nodeCounts[i - 1]), options);
+        });
+    }
+}
+test('snapshotMapReduce works as expected', () => __awaiter(void 0, void 0, void 0, function* () {
+    const results = yield (0, API_1.takeSnapshots)({
+        scenario: selfDefinedScenario,
+        evalInBrowserAfterInitLoad: injectTestObject,
+        snapshotForEachStep: true,
+    });
+    let analysis = new ExampleAnalysis();
+    yield (0, index_1.analyze)(results, analysis);
+    expect(analysis.isMonotonicIncreasing).toBe(true);
+    analysis = new ExampleAnalysis();
+    yield analysis.analyzeSnapshotsInDirectory(results.getSnapshotFileDir());
+    expect(analysis.isMonotonicIncreasing).toBe(true);
+}), E2ETestSettings_1.testTimeout);