"use strict"; Object.defineProperty(exports, "__esModule", { value: true }); exports["default"] = void 0; var _jsxAstUtils = require("jsx-ast-utils"); var _safeRegexTest = _interopRequireDefault(require("safe-regex-test")); var _schemas = require("../util/schemas"); var _getElementType = _interopRequireDefault(require("../util/getElementType")); function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; } /** * @fileoverview Performs validity check on anchor hrefs. Warns when anchors are used as buttons. * @author Almero Steyn * */ // ---------------------------------------------------------------------------- // Rule Definition // ---------------------------------------------------------------------------- var allAspects = ['noHref', 'invalidHref', 'preferButton']; var preferButtonErrorMessage = 'Anchor used as a button. Anchors are primarily expected to navigate. Use the button element instead. Learn more: https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/HEAD/docs/rules/anchor-is-valid.md'; var noHrefErrorMessage = 'The href attribute is required for an anchor to be keyboard accessible. Provide a valid, navigable address as the href value. If you cannot provide an href, but still need the element to resemble a link, use a button and change it with appropriate styles. Learn more: https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/HEAD/docs/rules/anchor-is-valid.md'; var invalidHrefErrorMessage = 'The href attribute requires a valid value to be accessible. Provide a valid, navigable address as the href value. If you cannot provide a valid href, but still need the element to resemble a link, use a button and change it with appropriate styles. Learn more: https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/HEAD/docs/rules/anchor-is-valid.md'; var schema = (0, _schemas.generateObjSchema)({ components: _schemas.arraySchema, specialLink: _schemas.arraySchema, aspects: (0, _schemas.enumArraySchema)(allAspects, 1) }); var _default = exports["default"] = { meta: { docs: { url: 'https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/tree/HEAD/docs/rules/anchor-is-valid.md', description: 'Enforce all anchors are valid, navigable elements.' }, schema: [schema] }, create: function create(context) { var elementType = (0, _getElementType["default"])(context); var testJShref = (0, _safeRegexTest["default"])(/^\W*?javascript:/); return { JSXOpeningElement: function JSXOpeningElement(node) { var attributes = node.attributes; var options = context.options[0] || {}; var componentOptions = options.components || []; var typeCheck = ['a'].concat(componentOptions); var nodeType = elementType(node); // Only check anchor elements and custom types. if (typeCheck.indexOf(nodeType) === -1) { return; } // Set up the rule aspects to check. var aspects = options.aspects || allAspects; // Create active aspect flag object. Failing checks will only report // if the related flag is set to true. var activeAspects = {}; allAspects.forEach(function (aspect) { activeAspects[aspect] = aspects.indexOf(aspect) !== -1; }); var propOptions = options.specialLink || []; var propsToValidate = ['href'].concat(propOptions); var values = propsToValidate.map(function (prop) { return (0, _jsxAstUtils.getPropValue)((0, _jsxAstUtils.getProp)(node.attributes, prop)); }); // Checks if any actual or custom href prop is provided. var hasAnyHref = values.some(function (value) { return value != null; }); // Need to check for spread operator as props can be spread onto the element // leading to an incorrect validation error. var hasSpreadOperator = attributes.some(function (prop) { return prop.type === 'JSXSpreadAttribute'; }); var onClick = (0, _jsxAstUtils.getProp)(attributes, 'onClick'); // When there is no href at all, specific scenarios apply: if (!hasAnyHref) { // If no spread operator is found and no onClick event is present // it is a link without href. if (!hasSpreadOperator && activeAspects.noHref && (!onClick || onClick && !activeAspects.preferButton)) { context.report({ node, message: noHrefErrorMessage }); } // If no spread operator is found but an onClick is preset it should be a button. if (!hasSpreadOperator && onClick && activeAspects.preferButton) { context.report({ node, message: preferButtonErrorMessage }); } return; } // Hrefs have been found, now check for validity. var invalidHrefValues = values.filter(function (value) { return value != null && typeof value === 'string' && (!value.length || value === '#' || testJShref(value)); }); if (invalidHrefValues.length !== 0) { // If an onClick is found it should be a button, otherwise it is an invalid link. if (onClick && activeAspects.preferButton) { context.report({ node, message: preferButtonErrorMessage }); } else if (activeAspects.invalidHref) { context.report({ node, message: invalidHrefErrorMessage }); } } } }; } }; module.exports = exports.default;