檢測(cè)模式

導(dǎo)入模塊

import hichecker from '@ohos.hichecker';

常量

提供了所有規(guī)則類型的常量。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiChecker

hichecker.addCheckRule9+

addCheckRule(rule: bigint): void

添加一條或多條規(guī)則到系統(tǒng)，系統(tǒng)根據(jù)添加的規(guī)則進(jìn)行檢測(cè)或反饋。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiChecker

參數(shù)：

示例：

try {
    // 添加一條規(guī)則
    hichecker.addCheckRule(hichecker.RULE_CAUTION_PRINT_LOG);
    // 添加多條規(guī)則
    // hichecker.addCheckRule(
    //     hichecker.RULE_CAUTION_PRINT_LOG | hichecker.RULE_CAUTION_TRIGGER_CRASH);
} catch (err) {
    console.error(`code: ${err.code}, message: ${err.message}`);
}

hichecker.removeCheckRule9+

removeCheckRule(rule: bigint): void

刪除一條或多條規(guī)則，刪除的規(guī)則后續(xù)將不再生效。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiChecker

參數(shù)：

示例：

try {
    // 刪除一條規(guī)則
    hichecker.removeCheckRule(hichecker.RULE_CAUTION_PRINT_LOG);
    // 刪除多條規(guī)則
    // hichecker.removeCheckRule(
    //     hichecker.RULE_CAUTION_PRINT_LOG | hichecker.RULE_CAUTION_TRIGGER_CRASH);
} catch (err) {
    console.error(`code: ${err.code}, message: ${err.message}`);
}

hichecker.containsCheckRule9+

containsCheckRule(rule: bigint): boolean

當(dāng)前已添加的規(guī)則集中是否包含了某一個(gè)特定的規(guī)則，如果傳入的規(guī)則級(jí)別為線程級(jí)別，則僅在當(dāng)前線程中進(jìn)行查詢。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiChecker

參數(shù)：

返回值：

示例：

try {
    // 添加一條規(guī)則
    hichecker.addCheckRule(hichecker.RULE_THREAD_CHECK_SLOW_PROCESS);

    // 查詢是否包含
    hichecker.containsCheckRule(hichecker.RULE_THREAD_CHECK_SLOW_PROCESS); // return true;
    hichecker.containsCheckRule(hichecker.RULE_CAUTION_PRINT_LOG); // return false;
} catch (err) {
    console.error(`code: ${err.code}, message: ${err.message}`);
}

hichecker.addRule(deprecated)

addRule(rule: bigint): void

添加一條或多條規(guī)則到系統(tǒng)，系統(tǒng)根據(jù)添加的規(guī)則進(jìn)行檢測(cè)或反饋。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiChecker

參數(shù)：

示例：

// 添加一條規(guī)則
hichecker.addRule(hichecker.RULE_CAUTION_PRINT_LOG);

// 添加多條規(guī)則
hichecker.addRule(
          hichecker.RULE_CAUTION_PRINT_LOG | hichecker.RULE_CAUTION_TRIGGER_CRASH);

hichecker.removeRule(deprecated)

removeRule(rule: bigint): void

刪除一條或多條規(guī)則，刪除的規(guī)則后續(xù)將不再生效。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiChecker

參數(shù)：

示例：

// 刪除一條規(guī)則
hichecker.removeRule(hichecker.RULE_CAUTION_PRINT_LOG);

// 刪除多條規(guī)則
hichecker.removeRule(
          hichecker.RULE_CAUTION_PRINT_LOG | hichecker.RULE_CAUTION_TRIGGER_CRASH);

hichecker.getRule

getRule(): bigint

獲取當(dāng)前線程規(guī)則、進(jìn)程規(guī)則、告警規(guī)則的合集。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiChecker

返回值：

示例：

// 添加一條規(guī)則
hichecker.addRule(hichecker.RULE_THREAD_CHECK_SLOW_PROCESS);

// 獲取已添加的規(guī)則
hichecker.getRule();   // return 1n;

hichecker.contains(deprecated)

contains(rule: bigint): boolean

當(dāng)前已添加的規(guī)則集中是否包含了某一個(gè)特定的規(guī)則，如果傳入的規(guī)則級(jí)別為線程級(jí)別，則僅在當(dāng)前線程中進(jìn)行查詢。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiChecker

參數(shù)：

返回值：

示例：

// 添加一條規(guī)則
hichecker.addRule(hichecker.RULE_THREAD_CHECK_SLOW_PROCESS);

// 查詢是否包含
hichecker.contains(hichecker.RULE_THREAD_CHECK_SLOW_PROCESS); // return true;
hichecker.contains(hichecker.RULE_CAUTION_PRINT_LOG); // return false;