memlab 1.1.6-alpha → 1.1.9-alpha

package/README.md

@@ -9,14 +9,16 @@ for analyzing heap snapshots taken from Chrome/Chromium, Node.js, Hermes, and El
 Install the CLI
 
 ```bash
-npm install -g memlab
+npm install -g @memlab
 ```
 
+### Find Memory Leaks
+
 To find memory leaks in Google Maps, you can create a scenario file defining how
 to interact with the Google Maps, let's name it `test-google-maps.js`:
 
 ```javascript
-// Visit Google Maps
+// initial page load url: Google Maps
 function url() {
   return 'https://www.google.com/maps/@37.386427,-122.0428214,11z';
 }
@@ -35,12 +37,27 @@ module.exports = {action, back, url};
 ```
 
 Now run memlab with the scenario file, memlab will interact with
-the web page and show detected memory leaks:
+the web page and detect memory leaks with built-in leak detectors:
 
 ```bash
 memlab run --scenario test-google-maps.js
 ```
 
+If you want to use a self-defined leak detector, add a `filterLeak` callback
+in the scenario file. `filterLeak` will be called for every unreleased heap
+object (`node`) allocated by the target interaction.
+
+```
+function filterLeak(node, heap) {
+  // ... your leak detector logic
+  // return true to mark the node as a memory leak
+};
+```
+
+`heap` is the graph representation of the final JavaScript heap snapshot.
+
+### Heap Analysis and Investigation
+
 View which object keeps growing in size during interaction in the previous run:
 ```bash
 memlab analyze unbound-object
@@ -52,7 +69,7 @@ Analyze pre-fetched v8/hermes `.heapsnapshot` files:
 memlab analyze unbound-object --snapshot-dir <DIR_OF_SNAPSHOT_FILES>
 ```
 
-Use `memlab analyze` to view all built-in memory analyses. For extension, view the [doc site](/tba).
+Use `memlab analyze` to view all built-in memory analyses. For extension, view the [doc site](https://facebookincubator.github.io/memlab).
 
 View retainer trace of a particular object:
 ```bash
@@ -63,7 +80,7 @@ Use `memlab help` to view all CLI commands.
 
 ## APIs
 
-Use the `memlab` package to start a E2E run in browser and detect memory leaks:
+Use the `memlab` npm package to start a E2E run in browser and detect memory leaks.
 
 ```javascript
 const memlab = require('memlab');

package/bin/memlab

@@ -0,0 +1,14 @@
+#!/usr/bin/env -S node --expose-gc --max-old-space-size=4096
+
+/**
+ * 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 cli = require("@memlab/cli");
+cli.run();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memlab",
-  "version": "1.1.6-alpha",
+  "version": "1.1.9-alpha",
   "license": "MIT",
   "description": "memlab is a framework that analyzes memory and finds memory leaks in JavaScript applications.",
   "main": "dist/index.js",
@@ -8,7 +8,7 @@
     "dist"
   ],
   "bin": {
-    "memlab": "node bin/memlab.js --expose-gc --max-old-space-size=4096"
+    "memlab": "bin/memlab"
   },
   "publishConfig": {
     "access": "public"