no-setter-return

禁止从 setter 返回值

✅

在配置文件中使用来自 @eslint/js 的 recommended 配置将启用此规则。

Setter 不能返回值。

虽然从 setter 返回值不会产生错误，但返回值会被忽略。因此，从 setter 返回值要么是不必要的，要么可能是错误，因为返回值无法使用。

规则详情

此规则禁止从 setter 返回值，并报告 setter 函数中的 return 语句。

仅允许不带值的 return，因为它是一个控制流语句。

此规则检查以下情况下的 setter：

对象字面量。
类声明和类表达式。
全局对象的 Object.create、Object.defineProperty、Object.defineProperties 和 Reflect.defineProperty 方法中的属性描述符。

此规则的错误代码示例

在代码沙盒中打开

/*eslint no-setter-return: "error"*/

var foo = {
    set a(value) {
        this.val = value;
        return value;
    }
};

class Foo {
    set a(value) {
        this.val = value * 2;
        return this.val;
    }
}

const Bar = class {
    static set a(value) {
        if (value < 0) {
            this.val = 0;
            return 0;
        }
        this.val = value;
    }
};

Object.defineProperty(foo, "bar", {
    set(value) {
        if (value < 0) {
            return false;
        }
        this.val = value;
    }
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

此规则的正确代码示例

在代码沙盒中打开

/*eslint no-setter-return: "error"*/

var foo = {
    set a(value) {
        this.val = value;
    }
};

class Foo {
    set a(value) {
        this.val = value * 2;
    }
}

const Bar = class {
    static set a(value) {
        if (value < 0) {
            this.val = 0;
            return;
        }
        this.val = value;
    }
};

Object.defineProperty(foo, "bar", {
    set(value) {
        if (value < 0) {
            throw new Error("Negative value.");
        }
        this.val = value;
    }
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

由 TypeScript 处理

在使用 TypeScript 时禁用此规则是安全的，因为 TypeScript 的编译器会强制执行此检查。

版本

此规则是在 ESLint v6.7.0 中引入的。

进一步阅读

setter - JavaScript | MDN
developer.mozilla.org

资源

编辑此页面

no-setter-return

规则详情

由 TypeScript 处理

相关规则

版本

进一步阅读

资源