fix(require-property): err if user blocks @property; fixes #1634

Author: brettz9

docs/rules/require-property.md

@@ -60,6 +60,16 @@ class Test {
  * @namespace {Object} SomeName
  */
 // Message: Missing JSDoc @property.
+
+/**
+ * @typedef {{id: string}} Something
+ *
+ * @return {{xyz: Something[]}}
+ */
+function foo( abc ) {
+}
+// Settings: {"jsdoc":{"tagNamePreference":{"property":false}}}
+// Message: Cannot prohibit `@property` in the `tagNamePreference` setting while using the `require-property` rule.
 ````
 
 

src/rules/requireProperty.js

@@ -1,6 +1,7 @@
 import iterateJsdoc from '../iterateJsdoc.js';
 
 export default iterateJsdoc(({
+  context,
   utils,
 }) => {
   const propertyAssociatedTags = utils.filterTags(({
@@ -18,6 +19,23 @@ export default iterateJsdoc(({
     tagName: 'property',
   }));
 
+  if (!targetTagName) {
+    context.report({
+      loc: {
+        end: {
+          column: 1,
+          line: 1,
+        },
+        start: {
+          column: 1,
+          line: 1,
+        },
+      },
+      message: 'Cannot prohibit `@property` in the `tagNamePreference` setting while using the `require-property` rule.',
+    });
+    return;
+  }
+
   if (utils.hasATag([
     targetTagName,
   ])) {

test/rules/assertions/requireProperty.js

@@ -89,6 +89,30 @@ export default /** @type {import('../index.js').TestCases} */ ({
            */
       `,
     },
+    {
+      code: `
+        /**
+         * @typedef {{id: string}} Something
+         *
+         * @return {{xyz: Something[]}}
+         */
+        function foo( abc ) {
+        }
+      `,
+      errors: [
+        {
+          line: 1,
+          message: 'Cannot prohibit `@property` in the `tagNamePreference` setting while using the `require-property` rule.',
+        },
+      ],
+      settings: {
+        jsdoc: {
+          tagNamePreference: {
+            property: false,
+          },
+        },
+      },
+    },
   ],
   valid: [
     {