Add function-name-arguments-allowed-list

lib/rules/function-name-arguments-whitelist/README.md

@@ -0,0 +1,69 @@
+# function-name-arguments-whitelist
+
+Specify a whitelist of allowed property and value pairs within declarations.
+
+<!-- prettier-ignore -->
+```css
+a { background-image: url('http://www.example.com/file.jpg'); }
+/** ↑               ↑
+ * These properties and these values */
+```
+
+## Options
+
+`object`: `{"unprefixed-function-name": ["string", "/regex/", /regex/] }`
+
+Given:
+
+```
+["data", "/^http/"]
+```
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { background-image: url('file://file.jpg'); }
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { background-image: url('example.com/file.jpg'); }
+```
+
+<!-- prettier-ignore -->
+```css
+a { background-image: url('/example.com/file.jpg'); }
+```
+
+<!-- prettier-ignore -->
+```css
+a { background-image: url('//example.com/file.jpg'); }
+```
+
+<!-- prettier-ignore -->
+```css
+a { background-image: url('./path/to/file.jpg'); }
+```
+
+<!-- prettier-ignore -->
+```css
+a { background-image: url('http://www.example.com/file.jpg'); }
+```
+
+<!-- prettier-ignore -->
+```css
+a { background-image: url('https://www.example.com/file.jpg'); }
+```
+
+<!-- prettier-ignore -->
+```css
+a { background-image: url('HTTPS://www.example.com/file.jpg'); }
+```
+
+<!-- prettier-ignore -->
+```css
+a { background-image: url('data:image/gif;base64,R0lGODlhAQABAIAAAAUEBAAAACwAAAAAAQABAAACAkQBADs='); }
+```

lib/rules/function-name-arguments-whitelist/__tests__/index.js

@@ -0,0 +1,71 @@
+'use strict';
+
+const { messages, ruleName } = require('..');
+
+testRule({
+	ruleName,
+
+	config: [['/^http/']],
+
+	accept: [
+		{
+			code: 'a { background: url(http://example.com/file.jpg); }',
+		},
+		{
+			code: 'a { background: url(HTTP://example.com/file.jpg); }',
+		},
+		{
+			code: 'a { background: url(https://example.com/file.jpg); }',
+		},
+	],
+
+	reject: [
+		{
+			code: 'a { background: url(ftp://example.com/file.jpg); }',
+			message: messages.rejected('ftp'),
+			line: 1,
+			column: 21,
+		},
+		{
+			code:
+				"a { background-image: url('data:image/gif;base64,R0lGODlhAQABAIAAAAUEBAAAACwAAAAAAQABAAACAkQBADs='); }",
+			message: messages.rejected('data'),
+			line: 1,
+			column: 27,
+		},
+	],
+});
+
+testRule({
+	ruleName,
+
+	config: [[/^http/]],
+
+	accept: [
+		{
+			code: 'a { background: url(http://example.com/file.jpg); }',
+		},
+		{
+			code: 'a { background: url(HTTP://example.com/file.jpg); }',
+		},
+		{
+			code: 'a { background: url(https://example.com/file.jpg); }',
+		},
+	],
+
+	reject: [
+		{
+			code: 'a { background: url(ftp://example.com/file.jpg); }',
+			message: messages.rejected('ftp'),
+			line: 1,
+			column: 21,
+		},
+		{
+			code:
+				"a { background-image: url('data:image/gif;base64,R0lGODlhAQABAIAAAAUEBAAAACwAAAAAAQABAAACAkQBADs='); }",
+			message: messages.rejected('data'),
+			line: 1,
+			column: 27,
+		},
+	],
+});

lib/rules/function-name-arguments-whitelist/index.js

@@ -0,0 +1,64 @@
+// @ts-nocheck
+
+'use strict';
+
+const _ = require('lodash');
+const functionArgumentsSearch = require('../../utils/functionArgumentsSearch');
+const getSchemeFromUrl = require('../../utils/getSchemeFromUrl');
+const isStandardSyntaxUrl = require('../../utils/isStandardSyntaxUrl');
+const matchesStringOrRegExp = require('../../utils/matchesStringOrRegExp');
+const report = require('../../utils/report');
+const ruleMessages = require('../../utils/ruleMessages');
+const validateOptions = require('../../utils/validateOptions');
+
+const ruleName = 'function-name-arguments-whitelist';
+
+const messages = ruleMessages(ruleName, {
+	rejected: (property, value) => `Unexpected arguments "${value}" for function "${property}"`,
+});
+
+function rule(whitelist) {
+	return (root, result) => {
+		const validOptions = validateOptions(result, ruleName, {
+			actual: whitelist,
+			possible: [_.isString, _.isRegExp],
+		});
+
+		if (!validOptions) {
+			return;
+		}
+
+		root.walkDecls((decl) => {
+			functionArgumentsSearch(decl.toString().toLowerCase(), 'url', (args, index) => {
+				const unspacedUrlString = _.trim(args, ' ');
+
+				if (!isStandardSyntaxUrl(unspacedUrlString)) {
+					return;
+				}
+
+				const urlString = _.trim(unspacedUrlString, '\'"');
+				const scheme = getSchemeFromUrl(urlString);
+
+				if (scheme === null) {
+					return;
+				}
+
+				if (matchesStringOrRegExp(scheme, whitelist)) {
+					return;
+				}
+
+				report({
+					message: messages.rejected(scheme),
+					node: decl,
+					index,
+					result,
+					ruleName,
+				});
+			});
+		});
+	};
+}
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+module.exports = rule;

lib/rules/index.js

@@ -145,6 +145,9 @@ const rules = {
 	'function-url-scheme-whitelist': importLazy(() => require('./function-url-scheme-whitelist'))(),
 	'function-whitelist': importLazy(() => require('./function-whitelist'))(),
 	'function-whitespace-after': importLazy(() => require('./function-whitespace-after'))(),
+	'function-name-arguments-whitelist': importLazy(() =>
+		require('./function-name-arguments-whitelist'),
+	)(),
 	'hue-degree-notation': importLazy(() => require('./hue-degree-notation'))(),
 	'keyframe-declaration-no-important': importLazy(() =>
 		require('./keyframe-declaration-no-important'),