hiperf_txt_parser 1.0.2 → 1.0.4

package/dist/backtrace.d.ts

@@ -0,0 +1,13 @@
+import type { PerfData, RecordSample } from "./types.js";
+/**
+ * 将 RecordSample 原始栈中符合 pattern 的帧转为 hstack 可解析的栈格式。
+ *
+ * 输出示例:
+ * #26 at triggerBinder (entry|entry|1.0.0|src/main/ets/myabilitystage/PreloadHook.ts:4:21)
+ */
+export declare function toBackTraceStack(sample: RecordSample): string;
+/**
+ * 批量将 PerfData 中所有 RecordSample 转为 hstack 可解析栈。
+ * 返回数组长度与 recordSamples 一致，元素顺序一一对应。
+ */
+export declare function toBackTraceStacks(data: PerfData): string[];

package/dist/backtrace.js

@@ -0,0 +1,33 @@
+// 例: 26:0x0000005ab8b4beee : triggerBinder:[url:entry|entry|1.0.0|src/main/ets/x.ts:4:21][...]
+const RAW_STACK_PATTERN = /^\s*(\d+):0x[0-9A-Za-z]+\s*:\s*([^\[]+?)\s*:\[url:([^\]]+)\].*$/;
+/**
+ * 将 RecordSample 原始栈中符合 pattern 的帧转为 hstack 可解析的栈格式。
+ *
+ * 输出示例:
+ * #26 at triggerBinder (entry|entry|1.0.0|src/main/ets/myabilitystage/PreloadHook.ts:4:21)
+ */
+export function toBackTraceStack(sample) {
+    const frames = sample.callchainFrames?.frames ?? [];
+    const out = [];
+    for (const frame of frames) {
+        const m = frame.match(RAW_STACK_PATTERN);
+        if (!m)
+            continue;
+        const index = m[1];
+        const funcName = m[2].trim();
+        const urlInfo = m[3].trim();
+        out.push(`#${index} at ${funcName} (${urlInfo})`);
+    }
+    console.info(`[hiperf_txt_parser] toBackTraceStack user stacks: ${out.length}/${frames.length}`);
+    return out.join("\n");
+}
+/**
+ * 批量将 PerfData 中所有 RecordSample 转为 hstack 可解析栈。
+ * 返回数组长度与 recordSamples 一致，元素顺序一一对应。
+ */
+export function toBackTraceStacks(data) {
+    const stacks = data.recordSamples.map((sample) => toBackTraceStack(sample));
+    const nonEmpty = stacks.filter((s) => s.length > 0).length;
+    console.info(`[hiperf_txt_parser] toBackTraceStacks processed recordSamples: ${data.recordSamples.length}, non-empty user stacks: ${nonEmpty}`);
+    return stacks;
+}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { parsePerfData, filterByTgid } from "./parser.js";
 export { formatPerfDataToText, formatPerfDataToJson } from "./serializer.js";
+export { toBackTraceStack, toBackTraceStacks } from "./backtrace.js";
 export type { PerfData, RecordSample } from "./types.js";
 export type { RecordSampleJsonExportItem } from "./serializer.js";

package/dist/index.js

@@ -1,2 +1,3 @@
 export { parsePerfData, filterByTgid } from "./parser.js";
 export { formatPerfDataToText, formatPerfDataToJson } from "./serializer.js";
+export { toBackTraceStack, toBackTraceStacks } from "./backtrace.js";

package/dist/parser.js

@@ -255,13 +255,16 @@ export function parsePerfData(text) {
             // 跳过无法解析的块
         }
     }
+    console.info(`[hiperf_txt_parser] parsePerfData parsed recordSamples: ${recordSamples.length}`);
     return { recordSamples };
 }
 /**
  * 按 tgid 过滤 RecordSample（当前以 pid 字段作为 tgid）
  */
 export function filterByTgid(data, tgid) {
-    return {
-        recordSamples: data.recordSamples.filter((sample) => sample.pid === tgid),
-    };
+    const before = data.recordSamples.length;
+    const afterSamples = data.recordSamples.filter((sample) => sample.pid === tgid);
+    const after = afterSamples.length;
+    console.info(`[hiperf_txt_parser] filterByTgid tgid=${tgid}, recordSamples: ${before} -> ${after}`);
+    return { recordSamples: afterSamples };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hiperf_txt_parser",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Parse perf data.txt and output structured TypeScript data",
   "type": "module",
   "main": "dist/index.js",