MatchRule

CORE · interface · Type contract

Order is priority. Patterns may inspect values, types, state or regular expressions.

Import

TypeScript

import type { MatchRule } from '@jangts/agent-core/support';

JavaScript

/** @typedef {import('@jangts/agent-core/support').MatchRule} MatchRule */

Other public entry points:@jangts/agent-core, @jangts/agent-core/types, @jangts/agent-core/structs, @jangts/agent-core/support.

Definition

interface MatchRule<Input, Result>

Type parameters

Type parameter	Constraint	Default type
Input	—	—
Result	—	void

Field structure

Field	Type	Required	Description
id	string	Required	Read-only. Unique rule id used in diagnostics.
description	string	Required	Read-only. See the type definition and usage context.
pattern	((input: Readonly<Input>) => boolean) | undefined	Optional	Read-only. Omission is an unconditional match at this position, normally the final fallback.
handle	(input: Input) => Result	Required	Read-only. Produces the rule's result; only the first matching rule runs.

Member index

Member	Purpose
handle	Produces the rule's result; only the first matching rule runs.

Member details

handle

Produces the rule's result; only the first matching rule runs.

MatchRule.handle(input: Input): Result

Parameter	Type	Passing	Description
input	Input	Required	—

Returns: Result.

Awaited value: Awaited<Result>.

Examples

• Rejection checks, first match, and sequential processing: Use real lists to express multiple checks and enumerated dispatch; a single ordinary condition can still use if.

One explicit rejection

Beginner · Node.js

TypeScript

import { Support } from '@jangts/agent-core';
const input = '你好';
Support.breakWhile(!input.trim(), '问题不能为空');
console.log(input);

JavaScript

import { Support } from '@jangts/agent-core';
const input = '你好';
Support.breakWhile(!input.trim(), '问题不能为空');
console.log(input);

Checks with dependencies evaluated in order

Configuration · Node.js

TypeScript

import { Support } from '@jangts/agent-core';
const input: unknown = { name: 'Ivan' };
Support.breakWhile([
  { occur: !input || typeof input !== 'object', error: '需要对象' },
  { occur: () => !('name' in (input as object)), error: '缺少 name' },
]);
console.log(input);

JavaScript

import { Support } from '@jangts/agent-core';
const input = { name: 'Ivan' };
Support.breakWhile([
    { occur: !input || typeof input !== 'object', error: '需要对象' },
    { occur: () => !('name' in input), error: '缺少 name' },
]);
console.log(input);

Related policy source

• Actual rules for rejection checks and match short-circuiting