# @falsejs/falsejs 中文文档

规范地址：https://npmcn.com/package/%40falsejs/falsejs/

版本：4\.1\.16
npm 元数据更新时间：2026-06-06T15:51:24.120Z
中文译文更新时间：2026-11-14T09:30:32.112Z
软件包许可：EGPSL10X-1\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40falsejs/falsejs
原文对照：https://npmcn.com/package/%40falsejs/falsejs/?lang=original
项目主页：https://github.com/enterprise-npm-ai/FalseJS
源码仓库：https://github.com/10xEngineersQualityProgramming/FalseJS

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.1 MB，13 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：268 个
- 首次发布：2025-09-12T18:27:27.734Z
- 最新版本发布：2026-06-06T15:51:24.011Z
- 近 30 天下载量：7411（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 21 个）

## 中文简介

虚假的JS

## 安装

```sh
npm install @falsejs/falsejs
```

也可以使用：`pnpm add @falsejs/falsejs`、`yarn add @falsejs/falsejs`、`bun add @falsejs/falsejs`

## README

![Logo](https://npmcn.com/package/%40falsejs/falsejs/falsejs-logo.png)

> 请捐给FalseJS 我们为图书馆付出了很大努力 我们认为你应该有所贡献.

# 虚假的JS

#### 比关键词本身更好.

曾经想过如果 JavaScript 更改了 `false` 其他东西的关键词,比如 `no`, (中文(简体) ), `nope`, (中文(简体) ), `noway`还是别的? 混乱。 这就是FalseJS的目的 在代码的开头,它检查是否 `false` 财务报告和审定财务报表 `true` 不存在,如果存在,它会重新定义它们。 这是使用图书馆的主要原因之一,如果 `false` 根本不存在,这还行(希望如此).

这10个试图获得假值,确保一个失败,它会继续到下一个,所以如果JavaScript打破一个,仍然会有更多的尝试. 这是图书馆的替代品 `false` 由 mde 编辑,使用硬码布尔值 `false` (我相信他们试图解决 在姊妹图书馆) `true`,这可能会 传递给 `false` 并且太短了。 假JS会更好 包括检查你的电脑是否也着了火,以防万一 _实值_ 着火了.

如果你想要一个更轻的包 回来 `false`,使用时 [虚值](https://github.com/js-constant/false-value)。 。 。 .

## 安装

用您最喜欢的软件包管理器安装 FalseJS .

国家预防机制: `npm install @falsejs/falsejs`

亚伦: `yarn add @falsejs/falsejs`

(原始内容存档于2017-09-26). PNPM: `pnpm add @falsejs/falsejs`

随要求导入 :

```javascript
const falsejs = require("@falsejs/falsejs").default
```

以导入方式导入 :

```javascript
import falsejs from "@falsejs/falsejs"
```

## 使用量

`falsejs.False` 是计算布尔值虚假并返回它的函数。 这需要三个论点.

```ts
function False(
  loggingEnabled?: "yes" | "no",
  shouldDoSomethingAsync?: "yes" | "no",
  shouldDoSomethingAsyncWithIsTenThousand?: "yes" | "no",
  disableAprilFoolsSideEffects?: "yes" | "no",
  definitelyDisableAprilFoolsSideEffects?: "yes" | "no",
  strictDisableAprilFoolsSideEffectsCheck?: "yes" | "no"
): boolean
```

第一个论点是: `loggingEnabled`,即是否输出有用和有趣的日志。 这可能是 `"yes"` 或者说 `"no"`。一些日志即使通过也可能仍然是输出 `"no"`,因为 FalseJS 使用其他库可以不经用户同意而登录事物. `"yes"` 财务报告和审定财务报表 `"no"` 基本上都是这样 `true` 财务报告和审定财务报表 `false`除了你称这个功能的全部原因 是为了得到一个布尔, 所以通过一个布尔是没有意义的.

第二个论点, `shouldDoSomethingAsync`,是 FalseJS 是否应该进行基于 Asyncronhous 承诺的设置 Timeout 以及完成时, 如果启用了日志, 输出 `[falsejs] Did something async` 在绿色。 这只是一个无意义的功能 默认 `"no"`因为它可以 `"yes"` 或者说 `"no"`。 。 。 .

第三个论点, `shouldDoSomethingAsyncWithIsTenThousand`,是否为 `is-ten-thousand`, FalseJS 使用的软件包, 在检查值为 10,000 之前, 应该有一个基于同步承诺的设置。 可能是这样 `"yes"` 或者说 `"no"`。 。 。 .

第四和第五次辩论, `disableAprilFoolsSideEffects` 财务报告和审定财务报表 `definitelyDisableAprilFoolsSideEffects`,可以是 `"yes"` 或者说 `"no"`两人必须 `"yes"` 绕过它的副作用 是四月愚人? 你可以问什么副作用? 这么说吧 FalseJS在4月的愚人节上做了不同的事情 如果这些不是四月愚人时被启用,那么错误就会被抛出,除非第六个参数, `strictDisableAprilFoolsSideEffectsCheck`,为 `"no"`。 。 。 .

最后的论据是相容模式参数. 这个有关于它如何工作的章节 是在例子之后.

## 示例

```javascript
const falsejs = require("@falsejs/falsejs").default
const falseValue = falsejs.False("yes", "yes", "yes", "yes", "yes", "no", falsejs.COMPATIBILITY_MODE.NONE) // outputs a bunch of logs

console.log(falseValue) // outputs false
```

## 相容模式

为了在互联网诞生以来的每一个已知的运行时间环境中确保返回的布尔的完整性 `falsejs.False` 函数支持可选 `compatibilityMode` 参数。 所执行的检查可能看起来是CPU密集而不必要的,但它们保证了运行时环境没有历史浏览器的颤音会威胁到虚假的稳定回放值.

举个例子:

```javascript
const myIE5CompatibleFalseValue = falsejs.False("yes", "yes", "yes", "yes", "yes", "no", falsejs.COMPATIBILITY_MODE.IE5) // Using IE5 compatibility mode
```

| 模式 | 说明 | 可能的副作用 |
| --- | --- | --- |
| `falsejs.COMPATIBILITY_MODE.NONE` | 现代标准行为 | 没有副作用和额外检查遗留的相容性 . |
| `falsejs.COMPATIBILITY_MODE.IE5` | 激活JScript引擎 强制卫队。 运行检查以确保 `false` 不被1999年的模拟环境不当转换. | 可能增加CPU的使用来模拟JScript垃圾收集. |
| `falsejs.COMPATIBILITY_MODE.NETSCAPE` | 激活JavaScript 1.1类型强制审计. 运行广泛的类型强制验证和审计已贬值的Netscape DOM `<layer>` 标签. | 可能由于重复的型号强制审计导致计算机超载,也可能由于JSDOM没有清理而导致内存出漏. |
| `falsejs.COMPATIBILITY_MODE.OPERA_PRESTO` | 模拟Presto引擎的单行本性,并审计已知的Opera非标准特性的全球状态. | 可能导致内存出漏出,并在~0ms后期屏蔽CPU. |

## `isFalse` 函数

FalseJS 也导出一个称为函数 `isFalse`,如果值是虚假的,则返回真实的。 这可以用来检验FalseJS是否工作并返回虚假(比如它不会,所以没有必要这样做). `falsejs.isFalse` 仅仅接受一个值,如果该值是虚假的,则返回真实值.

它需要两个参数, 值来检查它是否是虚假的 `loggingEnabled` 这可能是 `"yes"` 或者说 `"no"`。 。 。 .

示例

```javascript
const falsejs = require("@falsejs/falsejs").default
const falseValue = falsejs.False("yes", "yes", "yes", "yes", "yes", "no", falsejs.COMPATIBILITY_MODE.NONE)
const trueValue = require("true-value")

console.log(falsejs.isFalse(falseValue)) // true
console.log(falsejs.isFalse(false)) // probably true
console.log(falsejs.isFalse(trueValue)) // false
console.log(falsejs.isFalse("hi")) // false
```

`falsejs.isFalse` 也可以用来替代运行 `falsejs.False` 函数,而只是传递一个不虚假的值 `falsejs.isFalse`。 。 。 .

## 重要

FalseJS收集了远程测量和真知灼见,如平均成功尝试,你的OS,节点版本,运行FalseJS的CPU用法等. 要绕过这个,只需设置 `FalseJSTelemetryOptOut` 导入 FalseJS 之前, 全局属性为真实值 :

```js
global.FalseJSTelemetryOptOut = "yes"
```

所有收集的数据均可公开查阅 [此链接](https://falsejs-telemetry.vercel.app/)。我们不收集用户名和会话ID等敏感数据.

## 国 际

国家预防机制:

```bash
npm install -g @falsejs/falsejs
```

亚伦:

```bash
yarn add -g @falsejs/falsejs
```

(原始内容存档于2017-09-26). PNPM:

```bash
pnpm add -g @falsejs/falsejs
```

FalseJS提供CLI.

```bash
$ npm install -g @falsejs/falsejs
$ false
false
```

## j 查询插件

为 FalseJS 也提供了一个 j 查询插件 。 以下是一个例子:

```javascript
const falsejs = require("@falsejs/falsejs").default
global.jQuery = require("jquery")
falsejs.injectIntojQuery()

const $ = jQuery

const myFalseValue = $.False("yes", "yes", "yes", "yes", "yes", "no", falsejs.COMPATIBILITY_MODE.NONE)
console.log(myFalseValue) // false
console.log($.isFalse(myFalseValue)) // true
```

## 显示中间软件

也输出快取中件. 以下是一个例子:

```javascript
const express = require("express")
const falsejs = require("@falsejs/falsejs").default
const Bro = require("brototype")

const app = express()
const PORT = Bro(process).doYouEven("env.PORT") ? process.env.PORT : 3000

app.use(falsejs.expressMiddleware)

app.get("/", (req, res) => {
  res.send(req.isFalse(req.False("yes", "yes", "yes", "yes", "yes", "no", falsejs.COMPATIBILITY_MODE.NONE)) // sends true to the client
})

app.listen(PORT)
```

## 四月愚人行为

### **不是四月愚人节**

-   **假JS会回来** `false` 默认.
-   旗帜 `disableAprilFoolsSideEffects` 财务报告和审定财务报表 `definitelyDisableAprilFoolsSideEffects` **不影响行为** 伪JS。 它的正常行为就像它在任何非4月的愚人节一样.
    -   然而,如果 `strictDisableAprilFoolsSideEffectsCheck` 实值 **没有 `no"`** 转而 `"yes"` (默认是) `"yes"`),如果设置为 `"yes"`因为它不是四月愚人节, 没有副作用可以禁用.
    -   若为 `strictDisableAprilFoolsSideEffectsCheck` 设置为 **"没有"**, FalseJS 通常不会抛出错误,即使副作用参数设定为 `"yes"`。 。 。 .

### **四月愚人节**

-   **在4月的愚人节**虚构JS **总是返回 `true`**不论旗帜的状态如何.
-   **为了防止这种行为**,必须设置两个 `disableAprilFoolsSideEffects` 改为 `"yes"` 财务报告和审定财务报表 `definitelyDisableAprilFoolsSideEffects` 改为 `"yes"` 当你打电话给FalsejS.
    -   如果这些旗帜被设定为 `"yes"`, FalseJS 将返回其预期行为(返回) `false`即使是在4月的愚人节.

### **四月愚人行为的最佳使用**

这个用法可以保证你永远得到 `false` 不管是否是四月愚人 也没有错误.

```js
const falsejs = require("@falsejs/falsejs").default
const isAprilFools = require("is-april-fools")
const disableAprilFoolsSideEffects = isAprilFools() ? "yes" : "no"
const disableChecking = isAprilFools() ? "no" : "yes"

const falseValue = falsejs.False(
  "no",
  "no",
  "no" /*the first three options you can choose, for examples we set them all to "no"*/,
  disableAprilFoolsSideEffects,
  disableAprilFoolsSideEffects,
  disableChecking,
  falsejs.COMPATIBILITY_MODE.NETSCAPE // for this example we'll use netscape compatibility mode
)

// or you can do this, but the above is better

const falseValue = falsejs.False(
  "no",
  "no",
  "no" /*the first three options you can choose, for examples we set them all to "no"*/,
  "yes",
  "yes",
  "no",
  falsejs.COMPATIBILITY_MODE.NETSCAPE // for this example we'll use netscape compatibility mode
)
```

## 重要说明

在控制台中您可能看到这个错误 :

```
Warning: React does not recognize the `getMember` prop on a DOM element. If you intentionally want it to appear in the DOM as a custom attribute, spell it as lowercase `getmember` instead. If you accidentally passed it from a parent component, remove it from the DOM element.
    at div
    at NoComponent
```

这是正常的。 别担心 FalseJS 使用名为软件包 `get-member` 添加一个 `getMember` 方法对每个对象。 反应元素是物体,所以会变得混淆. 你可能会想,为什么有反应错误 即使你没有使用反应, 但FalseJS使用反应.

## 测试

FalseJS使用多个库进行测试. 运行 `npm test` 测试假JS.

## 相关项目

-   [虚值](https://github.com/js-constant/false-value) (这个更轻的版本)
-   [真值](https://github.com/js-constant/true-value) (回归真实)
-   [虚假](https://github.com/mde/false)
-   [真实](https://github.com/mde/true)
-   [选项真](https://github.com/donavon/alternative-true)
-   [未定义是- a- 函数](https://github.com/donavon/undefined-is-a-function)

## 许可证

FalseJS 使用 [EGPSL 10X-1.0 数据](https://github.com/10xEngineersQualityProgramming/EGPSL10X-1.0) 许可证

读取 [法律](https://github.com/10xly/legal)

## 由HEAVY BLACK Heart U+2764所制造

请进! 请! 请!  
请读一下 [许可证](https://github.com/10xly/legal/blob/main/LICENCE) 财务报告和审定财务报表 [行为守则](https://github.com/10xly/legal/blob/main/CODE_OF_CONDUCT.md)

## 当地雇员

这个图书馆的源代码太长了,你无法阅读,所以不用费心了.

## 常见问题

### @falsejs/falsejs 是什么？

虚假的JS

### 如何安装 @falsejs/falsejs？

在项目目录运行 npm install @falsejs/falsejs，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 false，可以用 npx false 直接运行。

### @falsejs/falsejs 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @falsejs/falsejs 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @falsejs/falsejs 可以商用吗？

@falsejs/falsejs 使用 EGPSL10X-1\.0 许可。声明的许可为 EGPSL10X-1\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @falsejs/falsejs 的下载量有多少？

根据 npm 官方下载统计，@falsejs/falsejs 在 2026/10/14 – 2026/11/12 这 30 天内被下载 7,411 次，日均约 247 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @falsejs/falsejs 还在维护吗？

最新版本 4\.1\.16 发布于 2026/06/06（5 个月前）；至今共发布 30 个版本，其中过去 12 个月发布了 21 个；首次发布于 2025/09/13。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。