Skip to content

Commit bb258a0

Browse files
cameroncookecodex
andcommitted
docs(size-analysis): Clarify wildcard filter matching
Document that matches and notMatches values use Sentry wildcard pattern syntax while simple operators expose decoded literal values. Refs EME-1061 Co-Authored-By: OpenAI Codex <noreply@openai.com>
1 parent b97f790 commit bb258a0

1 file changed

Lines changed: 2 additions & 1 deletion

File tree

docs/product/size-analysis/integrating-into-ci.mdx

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -237,9 +237,10 @@ Filter matching:
237237
- Objects in `filters` are combined with AND
238238
- Multiple `conditions` inside one filter are combined with OR
239239
- Each condition uses `values`; single-value operators still return a one-item array
240-
- Values in `filters` are decoded literal values, not query syntax. For example, `app_id:\*com` in `filterQuery` becomes `values: ["*com"]` with `operator: "equals"`
240+
- Values in `filters` are decoded literal values for exact/simple operators, not query syntax. For example, `app_id:\*com` in `filterQuery` becomes `values: ["*com"]` with `operator: "equals"`
241241
- The same key can appear in more than one filter object when positive and negative conditions both exist; those filter objects are still combined with AND
242242
- Supported filter operators are `equals`, `notEquals`, `in`, `notIn`, `contains`, `notContains`, `startsWith`, `notStartsWith`, `endsWith`, `notEndsWith`, `matches`, and `notMatches`
243+
- `matches` and `notMatches` values use Sentry wildcard pattern syntax. `*` matches zero or more characters, escaped `\*` matches a literal asterisk, and a pattern without `*` is an exact match. Simple wildcard patterns may be simplified to `startsWith`, `endsWith`, or `contains` instead.
243244
- `in` and `notIn` are evaluated as one condition against all values, matching Sentry's status check trigger behavior
244245
- A rule applies only when the build metadata matches all filters; if a referenced metadata key is missing, the filter does not match, even for negated operators
245246

0 commit comments

Comments
 (0)