diff --git a/docs/rules/jsx_boolean_value.md b/docs/rules/jsx_boolean_value.md new file mode 100644 index 00000000..fd2d8340 --- /dev/null +++ b/docs/rules/jsx_boolean_value.md @@ -0,0 +1,16 @@ +Enforce a consistent JSX boolean value style. Passing `true` as the boolean +value can be omitted with the shorthand syntax. + +### Invalid: + +```tsx +const foo = ; +const foo = ; +``` + +### Valid: + +```tsx +const foo = ; +const foo = ; +``` diff --git a/src/rules.rs b/src/rules.rs index 2b6a4a07..416bc4c0 100644 --- a/src/rules.rs +++ b/src/rules.rs @@ -24,6 +24,7 @@ pub mod fresh_handler_export; pub mod fresh_server_event_handlers; pub mod getter_return; pub mod guard_for_in; +pub mod jsx_boolean_value; pub mod no_array_constructor; pub mod no_async_promise_executor; pub mod no_await_in_loop; @@ -255,6 +256,7 @@ fn get_all_rules_raw() -> Vec> { Box::new(fresh_server_event_handlers::FreshServerEventHandlers), Box::new(getter_return::GetterReturn), Box::new(guard_for_in::GuardForIn), + Box::new(jsx_boolean_value::JSXBooleanValue), Box::new(no_array_constructor::NoArrayConstructor), Box::new(no_async_promise_executor::NoAsyncPromiseExecutor), Box::new(no_await_in_loop::NoAwaitInLoop), diff --git a/src/rules/jsx_boolean_value.rs b/src/rules/jsx_boolean_value.rs new file mode 100644 index 00000000..498bece8 --- /dev/null +++ b/src/rules/jsx_boolean_value.rs @@ -0,0 +1,97 @@ +// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license. + +use super::{Context, LintRule}; +use crate::handler::{Handler, Traverse}; +use crate::Program; +use deno_ast::view::{Expr, JSXAttr, JSXAttrValue, JSXExpr, Lit}; +use deno_ast::SourceRanged; + +#[derive(Debug)] +pub struct JSXBooleanValue; + +const CODE: &str = "jsx-boolean-value"; + +impl LintRule for JSXBooleanValue { + fn tags(&self) -> &'static [&'static str] { + &["react", "jsx"] + } + + fn code(&self) -> &'static str { + CODE + } + + fn lint_program_with_ast_view( + &self, + context: &mut Context, + program: Program, + ) { + JSXBooleanValueHandler.traverse(program, context); + } + + #[cfg(feature = "docs")] + fn docs(&self) -> &'static str { + include_str!("../../docs/rules/jsx_boolean_value.md") + } +} + +const MESSAGE: &str = + "Passing 'true' to boolean attributes is the same as not passing it`"; +const HINT: &str = "Remove the attribute value"; + +struct JSXBooleanValueHandler; + +impl Handler for JSXBooleanValueHandler { + fn jsx_attr(&mut self, node: &JSXAttr, ctx: &mut Context) { + if let Some(value) = node.value { + if let JSXAttrValue::JSXExprContainer(expr) = value { + if let JSXExpr::Expr(expr) = expr.expr { + if let Expr::Lit(lit) = expr { + if let Lit::Bool(lit_bool) = lit { + if lit_bool.value() { + ctx.add_diagnostic_with_hint( + value.range(), + CODE, + MESSAGE, + HINT, + ); + } + } + } + } + } + } + } +} + +// most tests are taken from ESlint, commenting those +// requiring code path support +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn jsx_no_comment_text_nodes_valid() { + assert_lint_ok! { + JSXBooleanValue, + filename: "file:///foo.jsx", + // non derived classes. + "", + "", + }; + } + + #[test] + fn jsx_no_comment_text_nodes_invalid() { + assert_lint_err! { + JSXBooleanValue, + filename: "file:///foo.jsx", + "": [ + { + col: 9, + message: MESSAGE, + hint: HINT, + } + ], + }; + } +} diff --git a/www/static/docs.json b/www/static/docs.json index 3361afd6..f9ca2d4d 100644 --- a/www/static/docs.json +++ b/www/static/docs.json @@ -111,6 +111,14 @@ "docs": "Require `for-in` loops to include an `if` statement\n\nLooping over objects with a `for-in` loop will include properties that are\ninherited through the prototype chain. This behavior can lead to unexpected\nitems in your for loop.\n\n### Invalid:\n\n```typescript\nfor (const key in obj) {\n foo(obj, key);\n}\n```\n\n### Valid:\n\n```typescript\nfor (const key in obj) {\n if (Object.hasOwn(obj, key)) {\n foo(obj, key);\n }\n}\n```\n\n```typescript\nfor (const key in obj) {\n if (!Object.hasOwn(obj, key)) {\n continue;\n }\n foo(obj, key);\n}\n```\n", "tags": [] }, + { + "code": "jsx-boolean-value", + "docs": "Enforce a consistent JSX boolean value style. Passing `true` as the boolean\nvalue can be omitted with the shorthand syntax.\n\n### Invalid:\n\n```tsx\nconst foo = ;\nconst foo = ;\n```\n\n### Valid:\n\n```tsx\nconst foo = ;\nconst foo = ;\n```\n", + "tags": [ + "react", + "jsx" + ] + }, { "code": "no-array-constructor", "docs": "Enforce conventional usage of array construction\n\nArray construction is conventionally done via literal notation such as `[]` or\n`[1, 2, 3]`. Using the `new Array()` is discouraged as is `new Array(1, 2, 3)`.\nThere are two reasons for this. The first is that a single supplied argument\ndefines the array length, while multiple arguments instead populate the array of\nno fixed size. This confusion is avoided when pre-populated arrays are only\ncreated using literal notation. The second argument to avoiding the `Array`\nconstructor is that the `Array` global may be redefined.\n\nThe one exception to this rule is when creating a new array of fixed size, e.g.\n`new Array(6)`. This is the conventional way to create arrays of fixed length.\n\n### Invalid:\n\n```typescript\n// This is 4 elements, not a size 100 array of 3 elements\nconst a = new Array(100, 1, 2, 3);\n\nconst b = new Array(); // use [] instead\n```\n\n### Valid:\n\n```typescript\nconst a = new Array(100);\nconst b = [];\nconst c = [1, 2, 3];\n```\n",