> For the complete documentation index, see [llms.txt](https://racoon-js.gitbook.io/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://racoon-js.gitbook.io/zh/jie-kou-shuo-ming/string/required.md).

# required

required(\[strict=false])

## 作用

限制被检测值不为`undefined | null`.

若开启严格模式***(strict=true)***, 则被检测值不允许为`undefiend | null | ''`。

## 参数

* `[strict]` ***(boolean)***  - 是否开启严格模式，默认为`false`不开启。当明确设置`strict=true`时，则开启严格模式。

## 示例

```javascript
const schema1 = racoon.string();
schema1.validate(undefined); // pass, 返回值为 undefined
schema1.validate(null); // pass, 返回值为 null
schema1.validate(''); // pass, 返回值为 空字符串

const schema2 = racoon.string().required();
schema2.validate(undefined); // fail
schema2.validate(null); // fail
schema2.validate(''); // pass

const schema3 = racoon.string().required(true);
schema3.validate(undefined); // fail
schema3.validate(null); // fail
schema3.validate(''); // fail
```