大网数据广告活动
Web 标准与前端开发

Modifier: (?ims-ims:...)

· 52CE 我爱测

A **modifier** overrides flag settings in a specific part of a regular expression. It can be used to enable or disable flags that change the meanings of certain regex syntax elements. These flags are `i`, `m`, and `s`.

A modifier overrides flag settings in a specific part of a regular expression. It can be used to enable or disable flags that change the meanings of certain regex syntax elements. These flags are i, m, and s.

Syntax

(?flags1:pattern)
(?flags1-flags2:pattern)

[!NOTE] JavaScript only has the "bounded" modifier form, where the pattern is placed inside the modifier group. Most other languages that support modifiers have an "unbounded" form, where the modifier is applied until the end of the closest containing group.

Parameters

  • flags1
    • : A string of flags to enable. Can contain any combination of i, m, and s.
  • flags2
    • : A string of flags to disable. Can contain any combination of i, m, and s, but must not contain any flags included in flags1.
  • pattern
    • : A pattern consisting of anything you may use in a regex literal, including a disjunction.

Description

Some flags change the meanings of regex syntax elements:

  • The i flag makes the regex case-insensitive by normalizing the case of literal characters and character classes.
  • The m flag changes the behavior of input boundary assertions ^ and $ to match the start and end of each line, in addition to the start and end of the input string.
  • The s flag changes the behavior of the wildcard . character to match any character, including line terminators.

Sometimes you may want these changes to only take effect in a specific part of a regex pattern. You can do so by wrapping that part in a modifier. For example:

/(?i:Hello) world/;

In this regex, the i flag is only enabled for the Hello part of the pattern. The world part is case-sensitive. Therefore, it matches Hello world, hello world, and HELLO world, but not HELLO WORLD. The following is equivalent, by enabling the i flag globally, and then disabling it for the world part:

/Hello (?-i:world)/i;

The flags1 and flags2 parameters can contain any combination of i, m, and s. However, the flags must all be unique between flags1 and flags2—you cannot enable or disable a flag twice, or enable a flag and then immediately disable it.

The flags1 and flags2 parameters are optional, but at least one must be non-empty. (?flags1-:pattern) is a modifier that only enables flags (equivalent to (?flags1:pattern)). (?-flags2:pattern) is a modifier that only disables flags. (?:pattern) is just a non-capturing group, and (?-:pattern) is a syntax error.

Other flags don't make sense in a modifier and are thus syntax errors if included:

  • The g and y flags determine how multiple calls to exec() behave and affect matching behavior of the whole regex.
  • The d flag enables additional information in the exec() result and affects matching behavior of the whole regex.
  • The u and v flags change the behavior of the regex engine in a way that's too complex to be locally modified. They also have global effects on the regex, such as how the lastIndex is advanced.

Examples

Matching a multiline format only at the start of the string

The following regex defines a format for a multiline string. The first ^ represents the start of the whole input string, by being inside a (?-m:) modifier, while all other ^ characters represent the start of a line:

const pattern = /(?-m:^)---\n^title:.*^slug:.*^---/ms;

const input = `---
title: "Modifier: (?ims-ims:...)"
slug: Web/JavaScript/Reference/Regular_expressions/Modifier
---`;

pattern.test(input); // true

// Extra line break at the start of string
const input2 = `\n${input}`;

pattern.test(input2); // false

Matching certain words case-insensitively

Imagine you are finding all variable declarations called foo or bar (because they are bad names). The word may appear in any case, but you know the keyword is always lowercase, so you can do this:

const pattern = /(?:var|let|const) (?i:foo|bar)\b/;

pattern.test("let foo;"); // true
pattern.test("const BAR = 1;"); // true
pattern.test("Let foo be a number"); // false

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。