Skip to main content

Class: StringAnalysis

Defined in: heap-analysis/src/plugins/StringAnalysis.ts:59

This analysis finds duplicated string instance in JavaScript heap and rank them based on the duplicated string size and count.

Extends​

Constructors​

Constructor​

new StringAnalysis(): StringAnalysis

Returns​

StringAnalysis

Inherited from​

BaseAnalysis.constructor

Methods​

analyzeSnapshotFromFile()​

analyzeSnapshotFromFile(file, options?): Promise\<AnalyzeSnapshotResult>

Defined in: heap-analysis/src/BaseAnalysis.ts:95

Run heap analysis for a single heap snapshot file

Parameters​

file​

string

the absolute path of a .heapsnapshot file.

options?​

RunHeapAnalysisOptions = {}

optional configuration for the heap analysis run

Returns​

Promise\<AnalyzeSnapshotResult>

this API returns AnalyzeSnapshotResult, which contains the logging file of analysis console output. Alternatively, to get more structured analysis results, check out the documentation of the hosting heap analysis class and call the analysis-specific API to get results after calling this method.

  • Example:
const analysis = new StringAnalysis();
// analysis console output is saved in result.analysisOutputFile
const result = await analysis.analyzeSnapshotFromFile(snapshotFile);
// query analysis-specific and structured results
const stringPatterns = analysis.getTopDuplicatedStringsInCount();

Additionally, you can specify a working directory to where the intermediate, logging, and final output files will be dumped:

const analysis = new StringAnalysis();
// analysis console output is saved in result.analysisOutputFile
// which is inside the specified working directory
const result = await analysis.analyzeSnapshotFromFile(snapshotFile, {
  // if the specified directory doesn't exist, memlab will create it
  workDir: '/tmp/your/work/dir',
});

Inherited from​

BaseAnalysis.analyzeSnapshotFromFile

getCommandName()​

getCommandName(): string

Defined in: heap-analysis/src/plugins/StringAnalysis.ts:120

get CLI command name for this memory analysis; use it with memlab analyze <ANALYSIS_NAME> in CLI

Returns​

string

command name

Overrides​

BaseAnalysis.getCommandName

getTopDuplicatedStringsInCount()​

getTopDuplicatedStringsInCount(): StringRecord[]

Defined in: heap-analysis/src/plugins/StringAnalysis.ts:70

get the top duplicated string in terms of duplicated string count

Returns​

StringRecord[]

an array of the top-duplicated strings' information