From 34468198ec672c3cca084949c411cb32743c2212 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Mon, 12 Jan 2015 16:39:54 +0100
Subject: [PATCH 01/54] Hide ProTip on dashboard if user comes from social
sharing
---
front/src/views/dashboard.html | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/front/src/views/dashboard.html b/front/src/views/dashboard.html
index e95421d..7d5a7b6 100644
--- a/front/src/views/dashboard.html
+++ b/front/src/views/dashboard.html
@@ -35,7 +35,7 @@
-
+
Did you know? Yellow Lab Tools now has an API!
Here is the JSON output for this run. Checkout
the API doc.
From 6521d2492580165f8dd087c80da823bd35b32c1c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Thu, 15 Jan 2015 12:19:25 +0100
Subject: [PATCH 02/54] Add quotes to user-agent in debug command line
---
lib/tools/phantomas/phantomasWrapper.js | 14 +++++++++++---
1 file changed, 11 insertions(+), 3 deletions(-)
diff --git a/lib/tools/phantomas/phantomasWrapper.js b/lib/tools/phantomas/phantomasWrapper.js
index bdef3d7..6c7937f 100644
--- a/lib/tools/phantomas/phantomasWrapper.js
+++ b/lib/tools/phantomas/phantomasWrapper.js
@@ -1,6 +1,7 @@
var async = require('async');
var Q = require('q');
var ps = require('ps-node');
+var path = require('path');
var debug = require('debug')('ylt:phantomaswrapper');
var phantomas = require('phantomas');
@@ -46,8 +47,8 @@ var PhantomasWrapper = function() {
'windowPerformance' // overriden
].join(','),
'include-dirs': [
- 'lib/tools/phantomas/custom_modules/core',
- 'lib/tools/phantomas/custom_modules/modules'
+ path.join(__dirname, 'custom_modules/core'),
+ path.join(__dirname, 'custom_modules/modules')
].join(',')
};
@@ -55,7 +56,14 @@ var PhantomasWrapper = function() {
debug('If you want to reproduce the phantomas task only, copy the following command line:');
var optionsString = '';
for (var opt in options) {
- optionsString += ' ' + '--' + opt + '=' + options[opt];
+ var value = options[opt];
+
+ if ((typeof value === 'string' || value instanceof String) && value.indexOf(' ') >= 0) {
+ value = '"' + value + '"';
+ }
+
+ optionsString += ' ' + '--' + opt + '=' + value;
+
}
debug('node node_modules/phantomas/bin/phantomas.js --url=' + task.url + optionsString + ' --verbose');
From 0f00111373d65be8a17ee2569aa91a5b934aa603 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Thu, 15 Jan 2015 12:34:47 +0100
Subject: [PATCH 03/54] Fix #39 Error 1001 when using the Node module
---
Gruntfile.js | 5 +-
.../custom_modules/modules/domQYLT/domQYLT.js | 2 +-
.../custom_modules/modules/jQYLT/jQYLT.js | 2 +-
.../modules/jsFileLoadYLT/jsFileLoadYLT.js | 29 ----------
.../custom_modules/util/collection.js | 54 +++++++++++++++++++
5 files changed, 59 insertions(+), 33 deletions(-)
delete mode 100644 lib/tools/phantomas/custom_modules/modules/jsFileLoadYLT/jsFileLoadYLT.js
create mode 100644 lib/tools/phantomas/custom_modules/util/collection.js
diff --git a/Gruntfile.js b/Gruntfile.js
index 197fe33..475359a 100644
--- a/Gruntfile.js
+++ b/Gruntfile.js
@@ -93,7 +93,9 @@ module.exports = function(grunt) {
coverage: {
files: [
{src: ['test/**'], dest: 'coverage/'},
- {src: ['lib/metadata/**'], dest: 'coverage/'}
+ {src: ['lib/metadata/**'], dest: 'coverage/'},
+ {src: ['node_modules/phantomas/**'], dest: 'coverage/'},
+ {src: ['lib/tools/phantomas/custom_modules/**'], dest: 'coverage/'}
]
},
build: {
@@ -336,7 +338,6 @@ module.exports = function(grunt) {
]);
grunt.registerTask('test-current-work', [
- 'build',
'jshint',
'express:testSuite',
'clean:coverage',
diff --git a/lib/tools/phantomas/custom_modules/modules/domQYLT/domQYLT.js b/lib/tools/phantomas/custom_modules/modules/domQYLT/domQYLT.js
index 81985f4..fe19cdc 100644
--- a/lib/tools/phantomas/custom_modules/modules/domQYLT/domQYLT.js
+++ b/lib/tools/phantomas/custom_modules/modules/domQYLT/domQYLT.js
@@ -289,7 +289,7 @@ exports.module = function(phantomas) {
// count DOM queries by either ID, tag name, class name and selector query
// @see https://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-document-doctype
- var Collection = require('../../../../../../node_modules/phantomas/lib/collection'),
+ var Collection = require('../../util/collection'),
DOMqueries = new Collection();
phantomas.on('domQuery', function(type, query, fnName, context) {
diff --git a/lib/tools/phantomas/custom_modules/modules/jQYLT/jQYLT.js b/lib/tools/phantomas/custom_modules/modules/jQYLT/jQYLT.js
index a850312..d76db71 100644
--- a/lib/tools/phantomas/custom_modules/modules/jQYLT/jQYLT.js
+++ b/lib/tools/phantomas/custom_modules/modules/jQYLT/jQYLT.js
@@ -276,7 +276,7 @@ exports.module = function(phantomas) {
// count Sizzle calls to detect duplicated queries
- var Collection = require('../../../../../../node_modules/phantomas/lib/collection'),
+ var Collection = require('../../util/collection'),
sizzleCalls = new Collection(),
jQueryLoading = new Collection();
diff --git a/lib/tools/phantomas/custom_modules/modules/jsFileLoadYLT/jsFileLoadYLT.js b/lib/tools/phantomas/custom_modules/modules/jsFileLoadYLT/jsFileLoadYLT.js
deleted file mode 100644
index 4aa6c7d..0000000
--- a/lib/tools/phantomas/custom_modules/modules/jsFileLoadYLT/jsFileLoadYLT.js
+++ /dev/null
@@ -1,29 +0,0 @@
-/**
- * Meters the number of page errors, and provides traces as offenders for "jsErrors" metric
- */
-
-exports.version = '0.0';
-
-exports.module = function(phantomas) {
- 'use strict';
-
- /*phantomas.on('recv', function(entry, res) {
- if (!entry.isJS) {
- return;
- }
-
- // Yeah, this is weird, i'm sending the information back to the browser...
- phantomas.evaluate(function(url) {
- (function(phantomas) {
-
- phantomas.pushContext({
- type: 'script loaded',
- callDetails: {
- arguments: [url]
- }
- });
-
- })(window.__phantomas);
- }, entry.url);
- });*/
-};
diff --git a/lib/tools/phantomas/custom_modules/util/collection.js b/lib/tools/phantomas/custom_modules/util/collection.js
new file mode 100644
index 0000000..db1ca7f
--- /dev/null
+++ b/lib/tools/phantomas/custom_modules/util/collection.js
@@ -0,0 +1,54 @@
+/**
+ * Push items and count them
+ */
+
+function collection() {
+ /* jshint validthis: true */
+ this.items = {};
+}
+
+collection.prototype = {
+ push: function(item) {
+ if (typeof this.items[item] === 'undefined') {
+ this.items[item] = {
+ cnt: 1
+ };
+ } else {
+ this.items[item].cnt++;
+ }
+ },
+
+ sort: function() {
+ var newItems = {},
+ sortedKeys;
+
+ // sort in descending order (by cnt)
+ sortedKeys = Object.keys(this.items).sort((function(a, b) {
+ return this.items[b].cnt - this.items[a].cnt;
+ }).bind(this));
+
+ // build new items dictionary
+ sortedKeys.forEach(function(key) {
+ newItems[key] = this.items[key];
+ }, this);
+
+ this.items = newItems;
+ return this;
+ },
+
+ forEach: function(callback) {
+ Object.keys(this.items).forEach(function(key) {
+ callback(key, this.items[key].cnt);
+ }, this);
+ },
+
+ has: function(item) {
+ return (typeof this.items[item] !== 'undefined');
+ },
+
+ getLength: function() {
+ return Object.keys(this.items).length;
+ }
+};
+
+module.exports = collection;
From 41c02cb7324d3cf76bf32ee924dd725df99148d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Fri, 16 Jan 2015 15:50:56 +0100
Subject: [PATCH 04/54] Remove coverage from 'grunt test-current-work' command
---
Gruntfile.js | 15 +++++++++------
1 file changed, 9 insertions(+), 6 deletions(-)
diff --git a/Gruntfile.js b/Gruntfile.js
index 475359a..819db4f 100644
--- a/Gruntfile.js
+++ b/Gruntfile.js
@@ -141,7 +141,7 @@ module.exports = function(grunt) {
options: {
reporter: 'spec',
},
- src: ['coverage/test/api/apiTest.js']
+ src: ['test/core/offendersHelpersTest.js']
},
coverage: {
options: {
@@ -184,6 +184,13 @@ module.exports = function(grunt) {
showStack: true
}
},
+ 'test-current-work': {
+ options: {
+ port: 8387,
+ server: './bin/server.js',
+ showStack: true
+ }
+ },
testSuite: {
options: {
port: 8388,
@@ -342,11 +349,7 @@ module.exports = function(grunt) {
'express:testSuite',
'clean:coverage',
'copy-test-server-settings',
- 'lineremover:beforeCoverage',
- 'copy:beforeCoverage',
- 'blanket',
- 'copy:coverage',
- 'express:test',
+ 'express:test-current-work',
'mochaTest:test-current-work',
'clean:tmp'
]);
From 49a6e4633a2d0f3c50f72ef194b743f70ff4e462 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Fri, 16 Jan 2015 15:51:45 +0100
Subject: [PATCH 05/54] Include angular-sanitize module
---
bower.json | 3 ++-
front/src/js/app.js | 1 +
front/src/main.html | 1 +
3 files changed, 4 insertions(+), 1 deletion(-)
diff --git a/bower.json b/bower.json
index 8609ca8..eb2c5d9 100644
--- a/bower.json
+++ b/bower.json
@@ -3,6 +3,7 @@
"dependencies": {
"angular": "~1.3.8",
"angular-route": "~1.3.8",
- "angular-resource": "~1.3.7"
+ "angular-resource": "~1.3.7",
+ "angular-sanitize": "~1.4.0-beta.0"
}
}
diff --git a/front/src/js/app.js b/front/src/js/app.js
index a7f73d3..0adc65f 100644
--- a/front/src/js/app.js
+++ b/front/src/js/app.js
@@ -1,5 +1,6 @@
var yltApp = angular.module('YellowLabTools', [
'ngRoute',
+ 'ngSanitize',
'indexCtrl',
'aboutCtrl',
'dashboardCtrl',
diff --git a/front/src/main.html b/front/src/main.html
index d966016..88f1dd6 100644
--- a/front/src/main.html
+++ b/front/src/main.html
@@ -20,6 +20,7 @@
+
From bce7a1ad9a0481ec68892f7a87eaf412bae93819 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Fri, 16 Jan 2015 15:52:56 +0100
Subject: [PATCH 06/54] Add the possibility to change offenders' layout
---
front/src/css/rule.css | 14 ++++
front/src/js/controllers/ruleCtrl.js | 5 +-
front/src/less/rule.less | 17 ++++
front/src/views/rule.html | 13 ++-
lib/metadata/policies.js | 14 +++-
lib/offendersHelpers.js | 65 +++++++++++++++
lib/rulesChecker.js | 29 +++++--
test/core/indexTest.js | 3 +-
test/core/offendersHelpersTest.js | 83 +++++++++++++++++++
test/core/rulesCheckerTest.js | 2 +-
test/fixtures/rulesCheckerOutput.json | 6 +-
...rPolicies.json => rulesCheckerPolicies.js} | 17 +++-
12 files changed, 248 insertions(+), 20 deletions(-)
create mode 100644 lib/offendersHelpers.js
create mode 100644 test/core/offendersHelpersTest.js
rename test/fixtures/{rulesCheckerPolicies.json => rulesCheckerPolicies.js} (86%)
diff --git a/front/src/css/rule.css b/front/src/css/rule.css
index 9fea690..57d9b17 100644
--- a/front/src/css/rule.css
+++ b/front/src/css/rule.css
@@ -82,3 +82,17 @@
font-size: 3em;
margin-bottom: 1em;
}
+.offendersHtml {
+ display: inline-block;
+}
+.offendersHtml .domTree div {
+ text-align: left;
+ margin-left: 1em;
+}
+.offendersHtml .domTree div span:only-child {
+ font-weight: bold;
+}
+.offendersHtml .domTree div span:only-child span {
+ font-style: italic;
+ font-weight: normal;
+}
diff --git a/front/src/js/controllers/ruleCtrl.js b/front/src/js/controllers/ruleCtrl.js
index 63fa2ef..e63adc1 100644
--- a/front/src/js/controllers/ruleCtrl.js
+++ b/front/src/js/controllers/ruleCtrl.js
@@ -22,7 +22,10 @@ ruleCtrl.controller('RuleCtrl', ['$scope', '$rootScope', '$routeParams', '$locat
function init() {
$scope.rule = $scope.result.rules[$scope.policyName];
- $scope.message = $sce.trustAsHtml($scope.rule.policy.message);
+
+ if (angular.isString($scope.rule.offenders)) {
+ $scope.htmlOffenders = $scope.rule.offenders;
+ }
}
$scope.backToDashboard = function() {
diff --git a/front/src/less/rule.less b/front/src/less/rule.less
index a12463a..feddc09 100644
--- a/front/src/less/rule.less
+++ b/front/src/less/rule.less
@@ -88,4 +88,21 @@
font-size: 3em;
margin-bottom: 1em;
}
+}
+
+.offendersHtml {
+ display: inline-block;
+
+ .domTree div {
+ text-align: left;
+ margin-left: 1em;
+
+ span:only-child {
+ font-weight: bold;
+ span {
+ font-style: italic;
+ font-weight: normal;
+ }
+ }
+ }
}
\ No newline at end of file
diff --git a/front/src/views/rule.html b/front/src/views/rule.html
index ee540ce..639ed91 100644
--- a/front/src/views/rule.html
+++ b/front/src/views/rule.html
@@ -10,24 +10,31 @@
Value: {{rule.value}}
-
+
Warning
This rule reached the abnormality threshold, which means there is a real problem you should care about.
-
+
+
404
Rule "{{policyName}}"" not found
diff --git a/lib/metadata/policies.js b/lib/metadata/policies.js
index b2b70fd..9c12353 100644
--- a/lib/metadata/policies.js
+++ b/lib/metadata/policies.js
@@ -1,4 +1,5 @@
var debug = require('debug')('ylt:policies');
+var offendersHelpers = require('../offendersHelpers');
var policies = {
"DOMelementsCount": {
@@ -15,7 +16,10 @@ var policies = {
"message": "
A deep DOM makes the CSS matching with DOM elements difficult.
It also slows down JavaScript modifications to the DOM because changing the dimensions of an element makes the browser re-calculate the dimensions of it's parents. Same thing for JavaScript events, that bubble up to the document root.
",
"isOkThreshold": 10,
"isBadThreshold": 20,
- "isAbnormalThreshold": 28
+ "isAbnormalThreshold": 28,
+ "offendersTransformFn": function(offenders) {
+ return offendersHelpers.listOfDomPathsToHTML(offenders);
+ }
},
"iframesCount": {
"tool": "phantomas",
@@ -31,7 +35,13 @@ var policies = {
"message": "
IDs of HTML elements must be document-wide unique. This can cause problems with getElementById returning the wrong element.
",
"isOkThreshold": 0,
"isBadThreshold": 5,
- "isAbnormalThreshold": 10
+ "isAbnormalThreshold": 10,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var results = /^(.*): (\d) occurrences$/.exec(offender);
+ return '
#' + results[1] + ': ' + results[2] + ' occurrences';
+ });
+ }
},
"DOMinserts": {
"tool": "phantomas",
diff --git a/lib/offendersHelpers.js b/lib/offendersHelpers.js
new file mode 100644
index 0000000..bbab2bf
--- /dev/null
+++ b/lib/offendersHelpers.js
@@ -0,0 +1,65 @@
+
+
+var OffendersHelpers = function() {
+
+
+ this.domPathToArray = function(str) {
+ return str.split(/\s?>\s?/);
+ };
+
+ this.listOfDomArraysToTree = function(listOfDomArrays) {
+ var result = {};
+
+ function recursiveTreeBuilder(tree, domArray) {
+ if (domArray.length > 0) {
+ var currentDomElement = domArray.shift(domArray);
+ if (tree === null) {
+ tree = {};
+ }
+ tree[currentDomElement] = recursiveTreeBuilder(tree[currentDomElement] || null, domArray);
+ return tree;
+ } else if (tree === null) {
+ return 1;
+ } else {
+ return tree + 1;
+ }
+ }
+
+ listOfDomArrays.forEach(function(domArray) {
+ result = recursiveTreeBuilder(result, domArray);
+ });
+
+ return result;
+ };
+
+ this.domTreeToHTML = function(domTree) {
+
+ function recursiveHtmlBuilder(tree) {
+ var html = '';
+ var keys = Object.keys(tree);
+
+ keys.forEach(function(key) {
+ if (isNaN(tree[key])) {
+ html += '
' + key + '' + recursiveHtmlBuilder(tree[key]) + '
';
+ } else if (tree[key] > 1) {
+ html += '
' + key + ' (x' + tree[key] + ')
';
+ } else {
+ html += '
' + key + '
';
+ }
+ });
+
+ return html;
+ }
+
+ return '
' + recursiveHtmlBuilder(domTree) + '
';
+ };
+
+ this.listOfDomPathsToHTML = function(domPaths) {
+ var domArrays = domPaths.map(this.domPathToArray);
+ var domTree = this.listOfDomArraysToTree(domArrays);
+ return this.domTreeToHTML(domTree);
+ };
+
+};
+
+module.exports = new OffendersHelpers();
\ No newline at end of file
diff --git a/lib/rulesChecker.js b/lib/rulesChecker.js
index f8eabd1..7fb238d 100644
--- a/lib/rulesChecker.js
+++ b/lib/rulesChecker.js
@@ -24,10 +24,12 @@ var RulesChecker = function() {
policy: policy
};
+ var offenders = [];
+
// Take DOMqueriesAvoidable's offenders from DOMqueriesDuplicated, for example.
if (policy.takeOffendersFrom) {
+
var fromList = policy.takeOffendersFrom;
- var offenders = [];
// takeOffendersFrom option can be a string or an array of strings.
if (typeof fromList === 'string') {
@@ -35,16 +37,31 @@ var RulesChecker = function() {
}
fromList.forEach(function(from) {
- offenders = offenders.concat(data.toolsResults[policy.tool].offenders[from]);
+ if (data.toolsResults[policy.tool] &&
+ data.toolsResults[policy.tool].offenders &&
+ data.toolsResults[policy.tool].offenders[from]) {
+ offenders = offenders.concat(data.toolsResults[policy.tool].offenders[from]);
+ }
});
data.toolsResults[policy.tool].offenders[metricName] = offenders;
+
+ } else if (data.toolsResults[policy.tool] &&
+ data.toolsResults[policy.tool].offenders &&
+ data.toolsResults[policy.tool].offenders[metricName]) {
+ offenders = data.toolsResults[policy.tool].offenders[metricName];
+ }
+
+ // It is possible to declare a transformation function for the offenders.
+ // The function should take an array of strings as single parameter and return a string.
+ if (policy.offendersTransformFn) {
+ rule.offendersCount = offenders.length;
+ offenders = policy.offendersTransformFn(offenders);
+ delete policy.offendersTransformFn;
}
- if (data.toolsResults[policy.tool].offenders &&
- data.toolsResults[policy.tool].offenders[metricName] &&
- data.toolsResults[policy.tool].offenders[metricName].length > 0) {
- rule.offenders = data.toolsResults[policy.tool].offenders[metricName];
+ if (offenders && offenders.length > 0) {
+ rule.offenders = offenders;
}
rule.bad = rule.value > policy.isOkThreshold;
diff --git a/test/core/indexTest.js b/test/core/indexTest.js
index 6207241..715f2f9 100644
--- a/test/core/indexTest.js
+++ b/test/core/indexTest.js
@@ -72,7 +72,8 @@ describe('index.js', function() {
"abnormal": false,
"score": 100,
"abnormalityScore": 0,
- "offenders": ["body > h1[1]"]
+ "offenders": "
",
+ "offendersCount": 1
});
// Test javascriptExecutionTree
diff --git a/test/core/offendersHelpersTest.js b/test/core/offendersHelpersTest.js
new file mode 100644
index 0000000..5c1a72c
--- /dev/null
+++ b/test/core/offendersHelpersTest.js
@@ -0,0 +1,83 @@
+var should = require('chai').should();
+var offendersHelpers = require('../../lib/offendersHelpers');
+
+describe('offendersHelpers', function() {
+
+ describe('domPathToArray', function() {
+
+ it('should transform a path to an array', function() {
+ var result = offendersHelpers.domPathToArray('body > section#page > div.alternate-color > ul.retroGuide > li[0] > div.retro-chaine.france2');
+ result.should.deep.equal(['body', 'section#page', 'div.alternate-color', 'ul.retroGuide', 'li[0]', 'div.retro-chaine.france2']);
+ });
+
+ it('should work even if a space is missing', function() {
+ var result = offendersHelpers.domPathToArray('body > section#page> div.alternate-color > ul.retroGuide >li[0] > div.retro-chaine.france2');
+ result.should.deep.equal(['body', 'section#page', 'div.alternate-color', 'ul.retroGuide', 'li[0]', 'div.retro-chaine.france2']);
+ });
+
+ });
+
+ describe('listOfDomArraysToTree', function() {
+
+ it('should transform a list of arrays into a tree', function() {
+ var result = offendersHelpers.listOfDomArraysToTree([
+ ['body', 'section#page', 'div.alternate-color', 'ul.retroGuide', 'li[0]', 'div.retro-chaine.france2'],
+ ['body', 'section#page', 'div.alternate-color', 'ul.retroGuide', 'li[0]', 'div.retro-chaine.france2'],
+ ['body', 'section#page', 'div.alternate-color', 'ul.retroGuide', 'li[1]', 'div.retro-chaine.france2']
+ ]);
+ result.should.deep.equal({
+ 'body': {
+ 'section#page': {
+ 'div.alternate-color': {
+ 'ul.retroGuide': {
+ 'li[0]': {
+ 'div.retro-chaine.france2': 2
+ },
+ 'li[1]': {
+ 'div.retro-chaine.france2': 1
+ }
+ }
+ }
+ }
+ }
+ });
+ });
+
+ });
+
+ describe('domTreeToHTML', function() {
+
+ it('should transform a dom tree into HTML with the awaited format', function() {
+ var result = offendersHelpers.domTreeToHTML({
+ 'body': {
+ 'ul.retroGuide': {
+ 'li[0]': {
+ 'div.retro-chaine.france2': 2
+ },
+ 'li[1]': {
+ 'div.retro-chaine.france2': 1
+ }
+ }
+ }
+ });
+
+ result.should.equal('
bodyul.retroGuideli[0]div.retro-chaine.france2 (x2)
li[1]div.retro-chaine.france2
');
+ });
+
+ });
+
+ describe('listOfDomPathsToHTML', function() {
+
+ it('should transform a list of path strings into HTML', function() {
+ var result = offendersHelpers.listOfDomPathsToHTML([
+ 'body > ul.retroGuide > li[0] > div.retro-chaine.france2',
+ 'body > ul.retroGuide > li[1] > div.retro-chaine.france2',
+ 'body > ul.retroGuide > li[0] > div.retro-chaine.france2',
+ ]);
+
+ result.should.equal('
bodyul.retroGuideli[0]div.retro-chaine.france2 (x2)
li[1]div.retro-chaine.france2
');
+ });
+
+ });
+
+});
diff --git a/test/core/rulesCheckerTest.js b/test/core/rulesCheckerTest.js
index 841c1ab..f979109 100644
--- a/test/core/rulesCheckerTest.js
+++ b/test/core/rulesCheckerTest.js
@@ -9,7 +9,7 @@ describe('rulesChecker', function() {
it('should produce a nice rules object', function() {
var data = require('../fixtures/rulesCheckerInput.json');
- var policies = require('../fixtures/rulesCheckerPolicies.json');
+ var policies = require('../fixtures/rulesCheckerPolicies');
var expected = require('../fixtures/rulesCheckerOutput.json');
var results = rulesChecker.check(data, policies);
diff --git a/test/fixtures/rulesCheckerOutput.json b/test/fixtures/rulesCheckerOutput.json
index 5327aa5..9f6ddf4 100644
--- a/test/fixtures/rulesCheckerOutput.json
+++ b/test/fixtures/rulesCheckerOutput.json
@@ -25,7 +25,8 @@
"takeOffendersFrom": "metric3"
},
"value": 222,
- "offenders": ["offender1", "offender2"],
+ "offenders": "offender1 - offender2",
+ "offendersCount": 2,
"bad": false,
"abnormal": false,
"score": 100,
@@ -41,7 +42,8 @@
"isAbnormalThreshold": 5000
},
"value": 6666,
- "offenders": ["offender1", "offender2"],
+ "offenders": "offender1/offender2",
+ "offendersCount": 2,
"bad": true,
"abnormal": true,
"score": 0,
diff --git a/test/fixtures/rulesCheckerPolicies.json b/test/fixtures/rulesCheckerPolicies.js
similarity index 86%
rename from test/fixtures/rulesCheckerPolicies.json
rename to test/fixtures/rulesCheckerPolicies.js
index 9147e01..a4fecab 100644
--- a/test/fixtures/rulesCheckerPolicies.json
+++ b/test/fixtures/rulesCheckerPolicies.js
@@ -1,4 +1,5 @@
-{
+var policies = {
+
"metric1": {
"tool": "tool1",
"label": "The metric 1",
@@ -14,7 +15,10 @@
"isOkThreshold": 1000,
"isBadThreshold": 3000,
"isAbnormalThreshold": 5000,
- "takeOffendersFrom": "metric3"
+ "takeOffendersFrom": "metric3",
+ "offendersTransformFn": function(offenders) {
+ return offenders.join(' - ');
+ }
},
"metric3": {
"tool": "tool1",
@@ -22,7 +26,10 @@
"message": "A great message",
"isOkThreshold": 1000,
"isBadThreshold": 3000,
- "isAbnormalThreshold": 5000
+ "isAbnormalThreshold": 5000,
+ "offendersTransformFn": function(offenders) {
+ return offenders.join('/');
+ }
},
"metric4": {
"tool": "tool1",
@@ -81,4 +88,6 @@
"isBadThreshold": 3000,
"isAbnormalThreshold": 5000
}
-}
\ No newline at end of file
+};
+
+module.exports = policies;
\ No newline at end of file
From a4f22a85426d52460d9ecac6ecda23638cef3927 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Sat, 17 Jan 2015 09:21:50 +0100
Subject: [PATCH 07/54] Offenders layout for DOM inserts
---
front/src/css/rule.css | 53 +++++++++++++++++++--
front/src/less/rule.less | 78 +++++++++++++++++++++++++++----
lib/metadata/policies.js | 13 ++++--
lib/offendersHelpers.js | 34 +++++++++++++-
test/core/offendersHelpersTest.js | 44 +++++++++++++++++
5 files changed, 205 insertions(+), 17 deletions(-)
diff --git a/front/src/css/rule.css b/front/src/css/rule.css
index 57d9b17..cbdcfee 100644
--- a/front/src/css/rule.css
+++ b/front/src/css/rule.css
@@ -82,17 +82,64 @@
font-size: 3em;
margin-bottom: 1em;
}
+.offenders .eltButton {
+ display: inline-block;
+ position: relative;
+ background: #efe;
+ padding: 0 0.5em;
+ margin: 0.2em 0;
+ border-radius: 0.4em;
+ z-index: 1;
+}
+.offenders .eltButton.opens {
+ padding-right: 0.75em;
+}
+.offenders .eltButton.opens:after {
+ position: relative;
+ left: 0.5em;
+ content: '\25BC';
+ font-size: 0.8em;
+}
+.offenders .eltButton > div {
+ display: none;
+ position: absolute;
+ right: 0;
+ min-width: 100%;
+ background: inherit;
+ border-bottom-left-radius: 0.4em;
+ border-bottom-right-radius: 0.4em;
+ border-top: 1px solid #999;
+}
+.offenders .eltButton .domTree {
+ text-align: left;
+ white-space: nowrap;
+}
+.offenders .eltButton .domTree > div {
+ margin: 0.5em;
+}
+.offenders .eltButton .domTree > div div {
+ margin-left: 1em;
+}
+.offenders .eltButton:hover {
+ border-bottom-left-radius: 0;
+ border-bottom-right-radius: 0;
+ background: #ffe0cc;
+ z-index: 2;
+}
+.offenders .eltButton:hover > div {
+ display: block;
+}
.offendersHtml {
display: inline-block;
}
-.offendersHtml .domTree div {
+.domTree div {
text-align: left;
margin-left: 1em;
}
-.offendersHtml .domTree div span:only-child {
+.domTree div span:only-child {
font-weight: bold;
}
-.offendersHtml .domTree div span:only-child span {
+.domTree div span:only-child span {
font-style: italic;
font-weight: normal;
}
diff --git a/front/src/less/rule.less b/front/src/less/rule.less
index feddc09..a54a753 100644
--- a/front/src/less/rule.less
+++ b/front/src/less/rule.less
@@ -90,19 +90,77 @@
}
}
-.offendersHtml {
- display: inline-block;
+.offenders {
+ .eltButton {
+ display: inline-block;
+ position: relative;
+ background: #efe;
+ padding: 0 0.5em;
+ margin: 0.2em 0;
+ border-radius: 0.4em;
+ z-index: 1;
- .domTree div {
- text-align: left;
- margin-left: 1em;
+ &.opens {
+ padding-right: 0.75em;
- span:only-child {
- font-weight: bold;
- span {
- font-style: italic;
- font-weight: normal;
+ &:after {
+ position: relative;
+ left: 0.5em;
+ content: '\25BC';
+ font-size: 0.8em;
+ }
+ }
+
+ > div {
+ display: none;
+ position: absolute;
+ right: 0;
+ min-width: 100%;
+ background: inherit;
+ border-bottom-left-radius: 0.4em;
+ border-bottom-right-radius: 0.4em;
+ border-top: 1px solid #999;
+ }
+
+ .domTree {
+ text-align: left;
+ white-space: nowrap;
+
+ > div {
+ margin: 0.5em;
+
+ div {
+ margin-left: 1em;
+ }
+ }
+ }
+
+ &:hover {
+ border-bottom-left-radius: 0;
+ border-bottom-right-radius: 0;
+ background: #ffe0cc;
+ z-index: 2;
+
+ & > div {
+ display: block;
}
}
}
+}
+
+.offendersHtml {
+ display: inline-block;
+}
+
+.domTree div {
+ text-align: left;
+ margin-left: 1em;
+
+ span:only-child {
+ font-weight: bold;
+ span {
+ font-style: italic;
+ font-weight: normal;
+ }
+ }
}
\ No newline at end of file
diff --git a/lib/metadata/policies.js b/lib/metadata/policies.js
index 9c12353..f0cdb18 100644
--- a/lib/metadata/policies.js
+++ b/lib/metadata/policies.js
@@ -38,8 +38,8 @@ var policies = {
"isAbnormalThreshold": 10,
"offendersTransformFn": function(offenders) {
return offenders.map(function(offender) {
- var results = /^(.*): (\d) occurrences$/.exec(offender);
- return '#' + results[1] + ': ' + results[2] + ' occurrences';
+ var parts = /^(.*): (\d) occurrences$/.exec(offender);
+ return '#' + parts[1] + ': ' + parts[2] + ' occurrences';
});
}
},
@@ -49,7 +49,14 @@ var policies = {
"message": "Working with the DOM in JavaScript triggers layout calculations and slows down the page.
Try, as much as possible, to have an HTML page fully generated by the server instead of making changes with JS.
",
"isOkThreshold": 10,
"isBadThreshold": 400,
- "isAbnormalThreshold": 1000
+ "isAbnormalThreshold": 1000,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var parts = /^"(.*)" appended to "(.*)"$/.exec(offender);
+
+ return offendersHelpers.domPathToButton(parts[1]) + ' appended to ' + offendersHelpers.domPathToButton(parts[2]);
+ });
+ }
},
"DOMqueries": {
"tool": "phantomas",
diff --git a/lib/offendersHelpers.js b/lib/offendersHelpers.js
index bbab2bf..24a523e 100644
--- a/lib/offendersHelpers.js
+++ b/lib/offendersHelpers.js
@@ -1,7 +1,6 @@
var OffendersHelpers = function() {
-
this.domPathToArray = function(str) {
return str.split(/\s?>\s?/);
@@ -60,6 +59,39 @@ var OffendersHelpers = function() {
return this.domTreeToHTML(domTree);
};
+ this.domPathToButton = function(domPath) {
+ var domArray = this.domPathToArray(domPath);
+ var domTree = this.listOfDomPathsToHTML([domPath]);
+
+ if (domArray[0] === 'html') {
+ return 'html
';
+ }
+ if (domArray[0] === 'body') {
+ if (domArray.length === 1) {
+ return 'body
';
+ } else {
+ return 'DOM element ' + domArray[domArray.length - 1] + '' + domTree + '
';
+ }
+ }
+ if (domArray[0] === 'head') {
+ return 'head
';
+ }
+ if (domArray[0] === 'DocumentFragment') {
+ if (domArray.length === 1) {
+ return 'Fragment
';
+ } else {
+ return 'Fragment element ' + domArray[domArray.length - 1] + '' + domTree + '
';
+ }
+ }
+
+ // Not attached element, such as just created with document.createElement()
+ if (domArray.length === 1) {
+ return 'Created element ' + domPath + '
';
+ } else {
+ return 'Created element ' + domArray[domArray.length - 1] + '' + domTree + '
';
+ }
+ };
+
};
module.exports = new OffendersHelpers();
\ No newline at end of file
diff --git a/test/core/offendersHelpersTest.js b/test/core/offendersHelpersTest.js
index 5c1a72c..30c2d15 100644
--- a/test/core/offendersHelpersTest.js
+++ b/test/core/offendersHelpersTest.js
@@ -80,4 +80,48 @@ describe('offendersHelpers', function() {
});
+ describe('domPathToButton', function() {
+
+ it('should transform html', function() {
+ var result = offendersHelpers.domPathToButton('html');
+ result.should.equal('html
');
+ });
+
+ it('should transform body', function() {
+ var result = offendersHelpers.domPathToButton('body');
+ result.should.equal('body
');
+ });
+
+ it('should transform head', function() {
+ var result = offendersHelpers.domPathToButton('head');
+ result.should.equal('head
');
+ });
+
+ it('should transform a standard in-body element', function() {
+ var result = offendersHelpers.domPathToButton('body > div#colorbox > div#cboxContent');
+ result.should.equal('');
+ });
+
+ it('should transform a domFragment element', function() {
+ var result = offendersHelpers.domPathToButton('DocumentFragment');
+ result.should.equal('Fragment
');
+ });
+
+ it('should transform a domFragment element', function() {
+ var result = offendersHelpers.domPathToButton('DocumentFragment > div#colorbox > div#cboxContent');
+ result.should.equal('');
+ });
+
+ it('should transform an not-attached element', function() {
+ var result = offendersHelpers.domPathToButton('div#sizcache');
+ result.should.equal('Created element div#sizcache
');
+ });
+
+ it('should transform an not-attached element path', function() {
+ var result = offendersHelpers.domPathToButton('div > div#sizcache');
+ result.should.equal('');
+ });
+
+ });
+
});
From 6fc502b0b2f3932bad5d59e8748a0f216a037959 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Sat, 17 Jan 2015 09:44:50 +0100
Subject: [PATCH 08/54] Offenders layout for DOM queries without results
---
lib/metadata/policies.js | 25 ++++++++++++++++++++++++-
lib/offendersHelpers.js | 3 +++
test/core/offendersHelpersTest.js | 5 +++++
3 files changed, 32 insertions(+), 1 deletion(-)
diff --git a/lib/metadata/policies.js b/lib/metadata/policies.js
index f0cdb18..046d9a2 100644
--- a/lib/metadata/policies.js
+++ b/lib/metadata/policies.js
@@ -39,6 +39,12 @@ var policies = {
"offendersTransformFn": function(offenders) {
return offenders.map(function(offender) {
var parts = /^(.*): (\d) occurrences$/.exec(offender);
+
+ if (!parts) {
+ debug('DOMidDuplicated offenders transform function error with "%s"', offender);
+ return offender;
+ }
+
return '#' + parts[1] + ': ' + parts[2] + ' occurrences';
});
}
@@ -54,6 +60,11 @@ var policies = {
return offenders.map(function(offender) {
var parts = /^"(.*)" appended to "(.*)"$/.exec(offender);
+ if (!parts) {
+ debug('DOMinserts offenders transform function error with "%s"', offender);
+ return offender;
+ }
+
return offendersHelpers.domPathToButton(parts[1]) + ' appended to ' + offendersHelpers.domPathToButton(parts[2]);
});
}
@@ -81,7 +92,19 @@ var policies = {
"message": "Number of queries that return no result.
It suggests the query is not used on the page, probably because it is some dead code.
Or maybe the code is trying to find an HTML block that is not always here. Look at the JS Timeline to see if the scripts correctly figures out the HTML block is not here and immediatly stops interacting further with the DOM.
",
"isOkThreshold": 0,
"isBadThreshold": 100,
- "isAbnormalThreshold": 200
+ "isAbnormalThreshold": 200,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var parts = /^(.*) \(in (.*)\) using (.*)$/.exec(offender);
+
+ if (!parts) {
+ debug('DOMqueriesWithoutResults offenders transform function error with "%s"', offender);
+ return offender;
+ }
+
+ return '' + parts[1] + ' (in ' + offendersHelpers.domPathToButton(parts[2]) + ') using ' + parts[3] + '';
+ });
+ }
},
"eventsBound": {
"tool": "phantomas",
diff --git a/lib/offendersHelpers.js b/lib/offendersHelpers.js
index 24a523e..1ce47ef 100644
--- a/lib/offendersHelpers.js
+++ b/lib/offendersHelpers.js
@@ -76,6 +76,9 @@ var OffendersHelpers = function() {
if (domArray[0] === 'head') {
return 'head
';
}
+ if (domArray[0] === '#document') {
+ return 'document
';
+ }
if (domArray[0] === 'DocumentFragment') {
if (domArray.length === 1) {
return 'Fragment
';
diff --git a/test/core/offendersHelpersTest.js b/test/core/offendersHelpersTest.js
index 30c2d15..4cea34c 100644
--- a/test/core/offendersHelpersTest.js
+++ b/test/core/offendersHelpersTest.js
@@ -97,6 +97,11 @@ describe('offendersHelpers', function() {
result.should.equal('head
');
});
+ it('should transform #document', function() {
+ var result = offendersHelpers.domPathToButton('#document');
+ result.should.equal('document
');
+ });
+
it('should transform a standard in-body element', function() {
var result = offendersHelpers.domPathToButton('body > div#colorbox > div#cboxContent');
result.should.equal('');
From 23dc46d697528d6d3b7baed52d288e6b360e9d12 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Mon, 19 Jan 2015 11:24:16 +0100
Subject: [PATCH 09/54] Offenders layout for DOMqueriesAvoidable, jsErrors and
globalVariables
---
front/src/css/rule.css | 21 +++---
front/src/less/rule.less | 6 +-
lib/metadata/policies.js | 74 +++++++++++++++----
lib/offendersHelpers.js | 68 +++++++++++++++---
test/core/offendersHelpersTest.js | 115 +++++++++++++++++++++++++++---
5 files changed, 240 insertions(+), 44 deletions(-)
diff --git a/front/src/css/rule.css b/front/src/css/rule.css
index cbdcfee..4f5f41d 100644
--- a/front/src/css/rule.css
+++ b/front/src/css/rule.css
@@ -82,7 +82,7 @@
font-size: 3em;
margin-bottom: 1em;
}
-.offenders .eltButton {
+.offenders .offenderButton {
display: inline-block;
position: relative;
background: #efe;
@@ -91,16 +91,16 @@
border-radius: 0.4em;
z-index: 1;
}
-.offenders .eltButton.opens {
+.offenders .offenderButton.opens {
padding-right: 0.75em;
}
-.offenders .eltButton.opens:after {
+.offenders .offenderButton.opens:after {
position: relative;
left: 0.5em;
content: '\25BC';
font-size: 0.8em;
}
-.offenders .eltButton > div {
+.offenders .offenderButton > div {
display: none;
position: absolute;
right: 0;
@@ -110,23 +110,26 @@
border-bottom-right-radius: 0.4em;
border-top: 1px solid #999;
}
-.offenders .eltButton .domTree {
+.offenders .offenderButton .domTree {
text-align: left;
white-space: nowrap;
}
-.offenders .eltButton .domTree > div {
+.offenders .offenderButton .domTree > div {
margin: 0.5em;
}
-.offenders .eltButton .domTree > div div {
+.offenders .offenderButton .domTree > div div {
margin-left: 1em;
}
-.offenders .eltButton:hover {
+.offenders .offenderButton .backtrace {
+ white-space: nowrap;
+}
+.offenders .offenderButton:hover {
border-bottom-left-radius: 0;
border-bottom-right-radius: 0;
background: #ffe0cc;
z-index: 2;
}
-.offenders .eltButton:hover > div {
+.offenders .offenderButton:hover > div {
display: block;
}
.offendersHtml {
diff --git a/front/src/less/rule.less b/front/src/less/rule.less
index a54a753..7a19d52 100644
--- a/front/src/less/rule.less
+++ b/front/src/less/rule.less
@@ -91,7 +91,7 @@
}
.offenders {
- .eltButton {
+ .offenderButton {
display: inline-block;
position: relative;
background: #efe;
@@ -135,6 +135,10 @@
}
}
+ .backtrace {
+ white-space: nowrap;
+ }
+
&:hover {
border-bottom-left-radius: 0;
border-bottom-right-radius: 0;
diff --git a/lib/metadata/policies.js b/lib/metadata/policies.js
index 046d9a2..8016d11 100644
--- a/lib/metadata/policies.js
+++ b/lib/metadata/policies.js
@@ -44,7 +44,7 @@ var policies = {
debug('DOMidDuplicated offenders transform function error with "%s"', offender);
return offender;
}
-
+
return '#' + parts[1] + ': ' + parts[2] + ' occurrences';
});
}
@@ -77,15 +77,6 @@ var policies = {
"isBadThreshold": 1000,
"isAbnormalThreshold": 2000
},
- "DOMqueriesAvoidable": {
- "tool": "phantomas",
- "label": "Duplicated DOM queries",
- "message": "This is the number of queries that could be avoided by removing all duplicated queries.
Simply save the result of a query in a variable. Ok it is not always simple, especially with third-party scripts, but at least do it with your own code.
",
- "isOkThreshold": 0,
- "isBadThreshold": 200,
- "isAbnormalThreshold": 500,
- "takeOffendersFrom": "DOMqueriesDuplicated"
- },
"DOMqueriesWithoutResults": {
"tool": "phantomas",
"label": "DOM queries without result",
@@ -102,7 +93,28 @@ var policies = {
return offender;
}
- return '' + parts[1] + ' (in ' + offendersHelpers.domPathToButton(parts[2]) + ') using ' + parts[3] + '';
+ return '' + parts[1] + ' (in ' + offendersHelpers.domPathToButton(parts[2]) + ') using ' + parts[3];
+ });
+ }
+ },
+ "DOMqueriesAvoidable": {
+ "tool": "phantomas",
+ "label": "Duplicated DOM queries",
+ "message": "This is the number of queries that could be avoided by removing all duplicated queries.
Simply save the result of a query in a variable. Ok it is not always simple, especially with third-party scripts, but at least do it with your own code.
",
+ "isOkThreshold": 0,
+ "isBadThreshold": 200,
+ "isAbnormalThreshold": 500,
+ "takeOffendersFrom": "DOMqueriesDuplicated",
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var parts = /^.* "(.*)" with (.*) \(in context (.*)\): (.*)\s?queries$/.exec(offender);
+
+ if (!parts) {
+ debug('DOMqueriesAvoidable offenders transform function error with "%s"', offender);
+ return offender;
+ }
+
+ return '' + parts[1] + ' (in ' + offendersHelpers.domPathToButton(parts[3]) + ') using ' + parts[2] + ': ' + parts[4] + ' queries';
});
}
},
@@ -112,7 +124,19 @@ var policies = {
"message": "Binding too many events has a cost.
It can be avoided by using \"event delegation\". Instead of binding events on each element one by one, events delegation binds them on the top level document element and uses the bubbling principle. It will imperceptibly slow down the event when it occurs, but the loading of the page will speed-up.
",
"isOkThreshold": 100,
"isBadThreshold": 800,
- "isAbnormalThreshold": 1500
+ "isAbnormalThreshold": 1500,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var parts = /^"(.*)" bound to "(.*)"$/.exec(offender);
+
+ if (!parts) {
+ debug('eventsBound offenders transform function error with "%s"', offender);
+ return offender;
+ }
+
+ return '' + parts[1] + ' bound to ' + offendersHelpers.domPathToButton(parts[2]);
+ });
+ }
},
"jsErrors": {
"tool": "phantomas",
@@ -120,7 +144,24 @@ var policies = {
"message": "Just to let you know there are some errors on the page.
Please note that some errors only occur in the PhantomJS browser, so you might need to double check on other browsers.
",
"isOkThreshold": 0,
"isBadThreshold": 1,
- "isAbnormalThreshold": 4
+ "isAbnormalThreshold": 4,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var parts = /^(.*) - (.*)$/.exec(offender);
+
+ if (!parts) {
+ debug('jsErrors offenders transform function error with "%s"', offender);
+ return offender;
+ }
+
+ var backtraceArray = offendersHelpers.backtraceToArray(parts[2]);
+ if (backtraceArray === null) {
+ return offender;
+ } else {
+ return '' + parts[1] + ' ' + offendersHelpers.backtraceArrayToHtml(backtraceArray);
+ }
+ });
+ }
},
"evalCalls": {
"tool": "phantomas",
@@ -152,7 +193,10 @@ var policies = {
"message": "It is a bad practice because they clutter up the global namespace. If two scripts use the same variable name in the global scope, it can cause conflicts and it is generally hard to debug.
Global variables also take a (very) little bit longer to be accessed than variables in the local scope of a function.
",
"isOkThreshold": 10,
"isBadThreshold": 50,
- "isAbnormalThreshold": 200
+ "isAbnormalThreshold": 200,
+ "offendersTransformFn": function(offenders) {
+ return offendersHelpers.sortVarsLikeChromeDevTools(offenders);
+ }
},
"jQueryVersion": {
"label": "jQuery version",
@@ -210,7 +254,7 @@ var policies = {
"jQueryDifferentVersions": {
"tool": "phantomas",
"label": "Several versions loaded",
- "message": "jQuery is a heavy library. You should never load jQuery more than one on the same page.
",
+ "message": "jQuery is a heavy library. You should never load jQuery more than once on the same page.
",
"isOkThreshold": 1,
"isBadThreshold": 2,
"isAbnormalThreshold": 2
diff --git a/lib/offendersHelpers.js b/lib/offendersHelpers.js
index 1ce47ef..6b427ab 100644
--- a/lib/offendersHelpers.js
+++ b/lib/offendersHelpers.js
@@ -11,7 +11,7 @@ var OffendersHelpers = function() {
function recursiveTreeBuilder(tree, domArray) {
if (domArray.length > 0) {
- var currentDomElement = domArray.shift(domArray);
+ var currentDomElement = domArray.shift();
if (tree === null) {
tree = {};
}
@@ -64,37 +64,85 @@ var OffendersHelpers = function() {
var domTree = this.listOfDomPathsToHTML([domPath]);
if (domArray[0] === 'html') {
- return 'html
';
+ return 'html
';
}
if (domArray[0] === 'body') {
if (domArray.length === 1) {
- return 'body
';
+ return 'body
';
} else {
- return 'DOM element ' + domArray[domArray.length - 1] + '' + domTree + '
';
+ return 'DOM element ' + domArray[domArray.length - 1] + '' + domTree + '
';
}
}
if (domArray[0] === 'head') {
- return 'head
';
+ return 'head
';
}
if (domArray[0] === '#document') {
- return 'document
';
+ return 'document
';
+ }
+ if (domArray[0] === 'window') {
+ return 'window
';
}
if (domArray[0] === 'DocumentFragment') {
if (domArray.length === 1) {
- return 'Fragment
';
+ return 'Fragment
';
} else {
- return 'Fragment element ' + domArray[domArray.length - 1] + '' + domTree + '
';
+ return 'Fragment element ' + domArray[domArray.length - 1] + '' + domTree + '
';
}
}
// Not attached element, such as just created with document.createElement()
if (domArray.length === 1) {
- return 'Created element ' + domPath + '
';
+ return 'Created element ' + domPath + '
';
} else {
- return 'Created element ' + domArray[domArray.length - 1] + '' + domTree + '
';
+ return 'Created element ' + domArray[domArray.length - 1] + '' + domTree + '
';
}
};
+
+ this.backtraceToArray = function(str) {
+ var traceArray = str.split(/ \/ /);
+
+ if (traceArray) {
+ var results = [];
+ var parts = null;
+
+ for (var i=0 ; ino backtrace ';
+ }
+
+ var html = '
';
+ };
+
+
+ this.sortVarsLikeChromeDevTools = function(vars) {
+ return vars.sort(function(a, b) {
+ return (a < b) ? -1 : 1;
+ });
+ };
+
};
module.exports = new OffendersHelpers();
\ No newline at end of file
diff --git a/test/core/offendersHelpersTest.js b/test/core/offendersHelpersTest.js
index 4cea34c..bf1a887 100644
--- a/test/core/offendersHelpersTest.js
+++ b/test/core/offendersHelpersTest.js
@@ -84,47 +84,144 @@ describe('offendersHelpers', function() {
it('should transform html', function() {
var result = offendersHelpers.domPathToButton('html');
- result.should.equal('
html
');
+ result.should.equal('
html
');
});
it('should transform body', function() {
var result = offendersHelpers.domPathToButton('body');
- result.should.equal('
body
');
+ result.should.equal('
body
');
});
it('should transform head', function() {
var result = offendersHelpers.domPathToButton('head');
- result.should.equal('
head
');
+ result.should.equal('
head
');
});
it('should transform #document', function() {
var result = offendersHelpers.domPathToButton('#document');
- result.should.equal('
document
');
+ result.should.equal('
document
');
+ });
+
+ it('should transform window', function() {
+ var result = offendersHelpers.domPathToButton('window');
+ result.should.equal('
window
');
});
it('should transform a standard in-body element', function() {
var result = offendersHelpers.domPathToButton('body > div#colorbox > div#cboxContent');
- result.should.equal('
');
+ result.should.equal('
');
});
it('should transform a domFragment element', function() {
var result = offendersHelpers.domPathToButton('DocumentFragment');
- result.should.equal('
Fragment
');
+ result.should.equal('
Fragment
');
});
it('should transform a domFragment element', function() {
var result = offendersHelpers.domPathToButton('DocumentFragment > div#colorbox > div#cboxContent');
- result.should.equal('
');
+ result.should.equal('
');
});
it('should transform an not-attached element', function() {
var result = offendersHelpers.domPathToButton('div#sizcache');
- result.should.equal('
Created element div#sizcache
');
+ result.should.equal('
Created element div#sizcache
');
});
it('should transform an not-attached element path', function() {
var result = offendersHelpers.domPathToButton('div > div#sizcache');
- result.should.equal('
');
+ result.should.equal('
');
+ });
+
+ });
+
+ describe('backtraceToArray', function() {
+
+ it('should transform a backtrace into an array', function() {
+ var result = offendersHelpers.backtraceToArray('http://pouet.com/js/jquery.footer-transverse-min-v1.0.20.js:1 / http://pouet.com/js/main.js:1');
+
+ result.should.deep.equal([
+ {
+ file: 'http://pouet.com/js/jquery.footer-transverse-min-v1.0.20.js',
+ line: 1
+ },
+ {
+ file: 'http://pouet.com/js/main.js',
+ line: 1
+ }
+ ]);
+ });
+
+ it('should return null if it fails', function() {
+ var result = offendersHelpers.backtraceToArray('http://pouet.com/js/jquery.footer-transverse-min-v1.0.20.js:1 /http://pouet.com/js/main.js:1');
+
+ should.equal(result, null);
+ });
+
+ });
+
+ describe('backtraceArrayToHtml', function() {
+
+ it('should create a button from a backtrace array', function() {
+ var result = offendersHelpers.backtraceArrayToHtml([
+ {
+ file: 'http://pouet.com/js/jquery.footer-transverse-min-v1.0.20.js',
+ line: 1
+ },
+ {
+ file: 'http://pouet.com/js/main.js',
+ line: 1
+ }
+ ]);
+
+ result.should.equal('
');
+ });
+
+ it('should display "no backtrace"', function() {
+ var result = offendersHelpers.backtraceArrayToHtml([]);
+
+ result.should.equal('
no backtrace
');
+ });
+
+ });
+
+ describe('sortVarsLikeChromeDevTools', function() {
+
+ it('should sort in the same strange order', function() {
+ var result = offendersHelpers.sortVarsLikeChromeDevTools([
+ 'a',
+ 'aaa',
+ 'a2',
+ 'b',
+ 'A',
+ 'AAA',
+ 'B',
+ '_a',
+ '_aaa',
+ '__a',
+ 'a_a',
+ 'aA',
+ 'a__',
+ '$',
+ '$a'
+ ]);
+
+ result.should.deep.equal([
+ '$',
+ '$a',
+ 'A',
+ 'AAA',
+ 'B',
+ '__a',
+ '_a',
+ '_aaa',
+ 'a',
+ 'a2',
+ 'aA',
+ 'a__',
+ 'a_a',
+ 'aaa',
+ 'b'
+ ]);
});
});
From 4ef83a844fc81f4b9bb3d39fe39105a90d133b13 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Mon, 19 Jan 2015 12:15:05 +0100
Subject: [PATCH 10/54] Fix offendersTransformFn deleted after the first run
---
lib/rulesChecker.js | 15 ++++++++++++---
1 file changed, 12 insertions(+), 3 deletions(-)
diff --git a/lib/rulesChecker.js b/lib/rulesChecker.js
index 7fb238d..8f82b68 100644
--- a/lib/rulesChecker.js
+++ b/lib/rulesChecker.js
@@ -1,3 +1,5 @@
+var extend = require('util')._extend;
+
var debug = require('debug')('ylt:ruleschecker');
var RulesChecker = function() {
@@ -21,7 +23,7 @@ var RulesChecker = function() {
rule = {
value: data.toolsResults[policy.tool].metrics[metricName],
- policy: policy
+ policy: extend({}, policy) // Clone object policy instead of reference
};
var offenders = [];
@@ -56,8 +58,15 @@ var RulesChecker = function() {
// The function should take an array of strings as single parameter and return a string.
if (policy.offendersTransformFn) {
rule.offendersCount = offenders.length;
- offenders = policy.offendersTransformFn(offenders);
- delete policy.offendersTransformFn;
+
+ try {
+ offenders = policy.offendersTransformFn(offenders);
+ } catch(err) {
+ debug('Error while transforming offenders for %s', metricName);
+ debug(err);
+ }
+
+ delete rule.policy.offendersTransformFn;
}
if (offenders && offenders.length > 0) {
From e6bd0d0006bc0cf5deda7cf77254724be897dc37 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Mon, 19 Jan 2015 12:16:19 +0100
Subject: [PATCH 11/54] Strange spaces disapearance in offenders
---
lib/metadata/policies.js | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/lib/metadata/policies.js b/lib/metadata/policies.js
index 8016d11..f1c9d7d 100644
--- a/lib/metadata/policies.js
+++ b/lib/metadata/policies.js
@@ -38,7 +38,7 @@ var policies = {
"isAbnormalThreshold": 10,
"offendersTransformFn": function(offenders) {
return offenders.map(function(offender) {
- var parts = /^(.*): (\d) occurrences$/.exec(offender);
+ var parts = /^(.*): ?(\d) ?occurrences$/.exec(offender);
if (!parts) {
debug('DOMidDuplicated offenders transform function error with "%s"', offender);
@@ -58,7 +58,7 @@ var policies = {
"isAbnormalThreshold": 1000,
"offendersTransformFn": function(offenders) {
return offenders.map(function(offender) {
- var parts = /^"(.*)" appended to "(.*)"$/.exec(offender);
+ var parts = /^"(.*)" ?appended ?to ?"(.*)"$/.exec(offender);
if (!parts) {
debug('DOMinserts offenders transform function error with "%s"', offender);
@@ -86,7 +86,7 @@ var policies = {
"isAbnormalThreshold": 200,
"offendersTransformFn": function(offenders) {
return offenders.map(function(offender) {
- var parts = /^(.*) \(in (.*)\) using (.*)$/.exec(offender);
+ var parts = /^(.*) ?\(in ?(.*)\) ?using ?(.*)$/.exec(offender);
if (!parts) {
debug('DOMqueriesWithoutResults offenders transform function error with "%s"', offender);
@@ -107,7 +107,7 @@ var policies = {
"takeOffendersFrom": "DOMqueriesDuplicated",
"offendersTransformFn": function(offenders) {
return offenders.map(function(offender) {
- var parts = /^.* "(.*)" with (.*) \(in context (.*)\): (.*)\s?queries$/.exec(offender);
+ var parts = /^.* "(.*)" ?with ?(.*) ?\(in ?context ?(.*)\): ?(.*)\s?queries$/.exec(offender);
if (!parts) {
debug('DOMqueriesAvoidable offenders transform function error with "%s"', offender);
@@ -127,7 +127,7 @@ var policies = {
"isAbnormalThreshold": 1500,
"offendersTransformFn": function(offenders) {
return offenders.map(function(offender) {
- var parts = /^"(.*)" bound to "(.*)"$/.exec(offender);
+ var parts = /^"(.*)" ?bound ?to ?"(.*)"$/.exec(offender);
if (!parts) {
debug('eventsBound offenders transform function error with "%s"', offender);
From cac36727e8ba9367767e93849f9702afc6a07ddc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Mon, 19 Jan 2015 12:16:56 +0100
Subject: [PATCH 12/54] Handle function names in backtraces
---
front/src/css/rule.css | 1 +
front/src/less/rule.less | 1 +
lib/offendersHelpers.js | 19 +++++++++++++------
test/core/offendersHelpersTest.js | 6 ++++--
4 files changed, 19 insertions(+), 8 deletions(-)
diff --git a/front/src/css/rule.css b/front/src/css/rule.css
index 4f5f41d..80474b4 100644
--- a/front/src/css/rule.css
+++ b/front/src/css/rule.css
@@ -122,6 +122,7 @@
}
.offenders .offenderButton .backtrace {
white-space: nowrap;
+ padding: 0.5em;
}
.offenders .offenderButton:hover {
border-bottom-left-radius: 0;
diff --git a/front/src/less/rule.less b/front/src/less/rule.less
index 7a19d52..71bb103 100644
--- a/front/src/less/rule.less
+++ b/front/src/less/rule.less
@@ -137,6 +137,7 @@
.backtrace {
white-space: nowrap;
+ padding: 0.5em;
}
&:hover {
diff --git a/lib/offendersHelpers.js b/lib/offendersHelpers.js
index 6b427ab..39a048f 100644
--- a/lib/offendersHelpers.js
+++ b/lib/offendersHelpers.js
@@ -107,13 +107,19 @@ var OffendersHelpers = function() {
var parts = null;
for (var i=0 ; i' + backtraceObj.file + ' line ' + backtraceObj.line + ' ';
+ var functionName = (backtraceObj.functionName) ? backtraceObj.functionName + '() ' : '';
+ html += '';
});
return html + '';
};
diff --git a/test/core/offendersHelpersTest.js b/test/core/offendersHelpersTest.js
index bf1a887..ce23d07 100644
--- a/test/core/offendersHelpersTest.js
+++ b/test/core/offendersHelpersTest.js
@@ -137,7 +137,7 @@ describe('offendersHelpers', function() {
describe('backtraceToArray', function() {
it('should transform a backtrace into an array', function() {
- var result = offendersHelpers.backtraceToArray('http://pouet.com/js/jquery.footer-transverse-min-v1.0.20.js:1 / http://pouet.com/js/main.js:1');
+ var result = offendersHelpers.backtraceToArray('http://pouet.com/js/jquery.footer-transverse-min-v1.0.20.js:1 / callback http://pouet.com/js/main.js:1');
result.should.deep.equal([
{
@@ -145,6 +145,7 @@ describe('offendersHelpers', function() {
line: 1
},
{
+ functionName: 'callback',
file: 'http://pouet.com/js/main.js',
line: 1
}
@@ -168,12 +169,13 @@ describe('offendersHelpers', function() {
line: 1
},
{
+ functionName: 'callback',
file: 'http://pouet.com/js/main.js',
line: 1
}
]);
- result.should.equal('');
+ result.should.equal('');
});
it('should display "no backtrace"', function() {
From fd2271f6d6c7a24369a65ce042e7b0893a01384f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Mon, 19 Jan 2015 20:31:06 +0100
Subject: [PATCH 13/54] Offenders layout for various CSS metrics
---
lib/metadata/policies.js | 192 ++++++++++++++++++++++++++++--
lib/offendersHelpers.js | 24 +++-
test/core/offendersHelpersTest.js | 41 ++++++-
3 files changed, 242 insertions(+), 15 deletions(-)
diff --git a/lib/metadata/policies.js b/lib/metadata/policies.js
index f1c9d7d..82ce5b7 100644
--- a/lib/metadata/policies.js
+++ b/lib/metadata/policies.js
@@ -38,7 +38,7 @@ var policies = {
"isAbnormalThreshold": 10,
"offendersTransformFn": function(offenders) {
return offenders.map(function(offender) {
- var parts = /^(.*): ?(\d) ?occurrences$/.exec(offender);
+ var parts = /^(.*): ?(\d+) ?occurrences$/.exec(offender);
if (!parts) {
debug('DOMidDuplicated offenders transform function error with "%s"', offender);
@@ -107,7 +107,7 @@ var policies = {
"takeOffendersFrom": "DOMqueriesDuplicated",
"offendersTransformFn": function(offenders) {
return offenders.map(function(offender) {
- var parts = /^.* "(.*)" ?with ?(.*) ?\(in ?context ?(.*)\): ?(.*)\s?queries$/.exec(offender);
+ var parts = /^[^"]* ?"(.*)" ?with ?(.*) ?\(in ?context ?(.*)\): ?(.*)\s?queries$/.exec(offender);
if (!parts) {
debug('DOMqueriesAvoidable offenders transform function error with "%s"', offender);
@@ -265,7 +265,34 @@ var policies = {
"message": "Yellow Lab Tools failed to parse a CSS file. I doubt the problem comes from the css parser.
Maybe a CSS validator can help you.
",
"isOkThreshold": 0,
"isBadThreshold": 1,
- "isAbnormalThreshold": 1
+ "isAbnormalThreshold": 1,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var parts = /^(([^ \(]*|) ?)?(?:\((((?! @ ).)*)( @ (\d+):(\d+))?\))?$/.exec(offender);
+
+ if (!parts) {
+ debug('cssParsingErrors offenders transform function error with "%s"', offender);
+ return offender;
+ }
+
+ var html = (parts[3]) ? parts[3] : '';
+
+ if (parts[2]) {
+ html += (parts[2] === '') ? ' <inline CSS>' : ' ' + offendersHelpers.urlToLink(parts[2]);
+ }
+
+ if (parts[5]) {
+ html += ' @ ' + parts[6] + ':' + parts[7];
+ }
+
+ if (parts[2] && parts[2] !== '') {
+ var w3cDirectUrl = 'http://jigsaw.w3.org/css-validator/validator?uri=' + encodeURIComponent(parts[2]) + '&profile=css3&usermedium=all&warning=no';
+ html += ' (Check on the W3C validator)';
+ }
+
+ return html;
+ });
+ }
},
"cssRules": {
"tool": "phantomas",
@@ -281,7 +308,14 @@ var policies = {
"message": "Complex selectors are CSS selectors with 4 or more expressions, like \"#header ul li .foo\".
They are adding more work for the browser, and this could be avoided by simplifying selectors.
",
"isOkThreshold": 0,
"isBadThreshold": 500,
- "isAbnormalThreshold": 2000
+ "isAbnormalThreshold": 2000,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+
+ return '' + splittedOffender.offender + ' @ ' + splittedOffender.line + ':' + splittedOffender.character;
+ });
+ }
},
"cssComplexSelectorsByAttribute": {
"tool": "phantomas",
@@ -289,7 +323,16 @@ var policies = {
"message": "Complex attributes selectors are one of these:
- .foo[type*=bar] (contains bar)
- .foo[type^=bar] (starts with bar)
- .foo[type|=bar] (starts with bar or bar-)
- .foo[type$=bar] (ends with bar)
- .foo[type~=bar baz] (bar or baz)
Their matching process needs more CPU and it has a cost on performances.
",
"isOkThreshold": 0,
"isBadThreshold": 50,
- "isAbnormalThreshold": 100
+ "isAbnormalThreshold": 100,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+
+ var boldedOffender = splittedOffender.offender.replace(/(\[[^ ]+[~\|\^\$\*]="[^"]+"\])/g, '$1');
+
+ return boldedOffender + ' @ ' + splittedOffender.line + ':' + splittedOffender.character;
+ });
+ }
},
"cssImports": {
"tool": "phantomas",
@@ -297,7 +340,14 @@ var policies = {
"message": "It’s bad for performance to use @import because CSS files don't get downloaded in parallel.
You should use <link rel='stylesheet' href='a.css'> instead.
",
"isOkThreshold": 0,
"isBadThreshold": 1,
- "isAbnormalThreshold": 1
+ "isAbnormalThreshold": 1,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+
+ return '' + splittedOffender.offender + ' @ ' + splittedOffender.line + ':' + splittedOffender.character;
+ });
+ }
},
"cssDuplicatedSelectors": {
"tool": "phantomas",
@@ -305,7 +355,19 @@ var policies = {
"message": "This is when two or more selectors are strictly identical and should be merged.
",
"isOkThreshold": 0,
"isBadThreshold": 40,
- "isAbnormalThreshold": 80
+ "isAbnormalThreshold": 80,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var parts = /^(.*) \((\d+) times\)$/.exec(offender);
+
+ if (!parts) {
+ debug('cssDuplicatedSelectors offenders transform function error with "%s"', offender);
+ return offender;
+ }
+
+ return parts[1] + ' (x' + parts[2] + ')';
+ });
+ }
},
"cssDuplicatedProperties": {
"tool": "phantomas",
@@ -313,7 +375,21 @@ var policies = {
"message": "This is the number of property definitions duplicated within a selector.
",
"isOkThreshold": 0,
"isBadThreshold": 50,
- "isAbnormalThreshold": 100
+ "isAbnormalThreshold": 100,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+
+ var parts = /^([^{]+) {([^ ]+): (.+)}$/.exec(splittedOffender.offender);
+
+ if (!parts) {
+ debug('cssDuplicatedProperties offenders transform function error with "%s"', offender);
+ return offender;
+ }
+
+ return 'Property ' + parts[2] + ' duplicated in ' + parts[1] + ' { } @ ' + splittedOffender.line + ':' + splittedOffender.character;
+ });
+ }
},
"cssEmptyRules": {
"tool": "phantomas",
@@ -321,7 +397,13 @@ var policies = {
"message": "Very easy to fix: remove all empty rules.
",
"isOkThreshold": 0,
"isBadThreshold": 40,
- "isAbnormalThreshold": 100
+ "isAbnormalThreshold": 100,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+ return '' + splittedOffender.offender + ' { } @ ' + splittedOffender.line + ':' + splittedOffender.character;
+ });
+ }
},
"cssExpressions": {
"tool": "phantomas",
@@ -329,7 +411,21 @@ var policies = {
"message": "Such as: expression( document.body.clientWidth > 600 ? \"600px\" : \"auto\" )
This is a bad practice as it slows down browsers. There are some simpler CSS3 methods for doing this.
",
"isOkThreshold": 0,
"isBadThreshold": 1,
- "isAbnormalThreshold": 20
+ "isAbnormalThreshold": 20,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+
+ var parts = /^(.*) {([^ ]+): expression\((.*)\)}$/.exec(splittedOffender.offender);
+
+ if (!parts) {
+ debug('cssExpressions offenders transform function error with "%s"', offender);
+ return offender;
+ }
+
+ return parts[1] + ' {' + parts[2] + ': expression(' + parts[3] + ')} @ ' + splittedOffender.line + ':' + splittedOffender.character;
+ });
+ }
},
"cssImportants": {
"tool": "phantomas",
@@ -337,7 +433,21 @@ var policies = {
"message": "It can be useful, but only as a last resort. It is a bad practice because it overrides the normal cascading logic. The more you use !important, the more you need it again to over-override. This conducts to a poor maintainability.
",
"isOkThreshold": 0,
"isBadThreshold": 50,
- "isAbnormalThreshold": 150
+ "isAbnormalThreshold": 150,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+
+ var parts = /^(.*) {([^ ]+): (.*) ?\!important}$/.exec(splittedOffender.offender);
+
+ if (!parts) {
+ debug('cssImportants offenders transform function error with "%s"', offender);
+ return offender;
+ }
+
+ return parts[1] + ' {' + parts[2] + ': ' + parts[3] + ' !important} @ ' + splittedOffender.line + ':' + splittedOffender.character;
+ });
+ }
},
"cssOldIEFixes": {
"tool": "phantomas",
@@ -345,7 +455,49 @@ var policies = {
"message": "What browser do you need to support? Once you've got the answer, take a look at these old rules that pollute your CSS code and remove them.
IE6:
- * html
- html > body (everything but IE6)
IE7:
- *height: 123px;
- height: 123px !ie;
IE9:
- -ms-filter
- progid:DXImageTransform.Microsoft
",
"isOkThreshold": 0,
"isBadThreshold": 50,
- "isAbnormalThreshold": 300
+ "isAbnormalThreshold": 300,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+
+ var parts = /^([^{]*)( {([^ ]+): (.*)})?$/.exec(splittedOffender.offender);
+
+ if (!parts) {
+ debug('cssOldIEFixes offenders transform function error with "%s"', offender);
+ return offender;
+ }
+
+ var rule = parts[1];
+ var property = parts[3];
+ var value = parts[4];
+ var browser = null;
+
+ if (rule.indexOf('* html') === 0) {
+ rule = rule.replace(/^\* html/, '* html');
+ browser = 'IE6';
+ } else if (rule.indexOf('html>body') === 0) {
+ rule = rule.replace(/^html>body/, 'html>body');
+ browser = 'IE6';
+ } else if (property.indexOf('*') === 0) {
+ property = '' + property + '';
+ browser = 'IE7';
+ } else if (value.match(/\!ie$/)) {
+ value = value.replace(/\!ie$/, '!ie');
+ browser = 'IE7';
+ } else if (property === '-ms-filter') {
+ property = '-ms-filter';
+ browser = 'IE9';
+ } else if (value.indexOf('progid:DXImageTransform.Microsoft') === 0) {
+ value = value.replace(/^progid:DXImageTransform\.Microsoft/, 'progid:DXImageTransform.Microsoft');
+ browser = 'IE9';
+ }
+
+ browser = browser ? '' + browser + ' fix: ' : '';
+ var propertyAndValue = (property && value) ? ' {' + property + ': ' + value + '}' : '';
+
+ return browser + rule + propertyAndValue + ' @ ' + splittedOffender.line + ':' + splittedOffender.character;
+ });
+ }
},
"cssOldPropertyPrefixes": {
"tool": "phantomas",
@@ -353,7 +505,21 @@ var policies = {
"message": "Many property prefixes such as -moz- or -webkit- are not needed anymore, or by very few people. You can remove them or replace them with the non-prefixed version. This will help reducing your stylesheets weight.
",
"isOkThreshold": 0,
"isBadThreshold": 50,
- "isAbnormalThreshold": 300
+ "isAbnormalThreshold": 300,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+
+ var parts = /^([^{]*)(?: { ([^ ]+): (.*) }) \/\/ (.*)$/.exec(splittedOffender.offender);
+
+ if (!parts) {
+ debug('cssOldPropertyPrefixes offenders transform function error with "%s"', offender);
+ return offender;
+ }
+
+ return '' + parts[1] + ' {' + parts[2] + ': ' + parts[3] + '} @ ' + splittedOffender.line + ':' + splittedOffender.character + '
' + parts[4] + '
';
+ });
+ }
},
"cssUniversalSelectors": {
"tool": "phantomas",
diff --git a/lib/offendersHelpers.js b/lib/offendersHelpers.js
index 39a048f..66b11f3 100644
--- a/lib/offendersHelpers.js
+++ b/lib/offendersHelpers.js
@@ -136,9 +136,10 @@ var OffendersHelpers = function() {
}
var html = '';
};
@@ -150,6 +151,27 @@ var OffendersHelpers = function() {
});
};
+ this.urlToLink = function(url) {
+ var shortUrl = (url.length > 110) ? url.substr(0, 47) + ' ... ' + url.substr(-48) : url;
+ return '' + shortUrl + '';
+ };
+
+ this.cssOffenderPattern = function(offender) {
+ var parts = /^(.*) @ (\d+):(\d+)$/.exec(offender);
+
+ if (!parts) {
+ return {
+ offender: offender
+ };
+ } else {
+ return {
+ offender: parts[1],
+ line: parseInt(parts[2], 10),
+ character: parseInt(parts[3], 10)
+ };
+ }
+ };
+
};
module.exports = new OffendersHelpers();
\ No newline at end of file
diff --git a/test/core/offendersHelpersTest.js b/test/core/offendersHelpersTest.js
index ce23d07..072d2d1 100644
--- a/test/core/offendersHelpersTest.js
+++ b/test/core/offendersHelpersTest.js
@@ -175,7 +175,7 @@ describe('offendersHelpers', function() {
}
]);
- result.should.equal('');
+ result.should.equal('');
});
it('should display "no backtrace"', function() {
@@ -228,4 +228,43 @@ describe('offendersHelpers', function() {
});
+ describe('urlToLink', function() {
+
+ it('should transform an url into an html link', function() {
+ var result = offendersHelpers.urlToLink('http://www.google.com/js/main.js');
+
+ result.should.equal('http://www.google.com/js/main.js');
+ });
+
+ it('should ellypsis the url if too long', function() {
+ var result = offendersHelpers.urlToLink('http://www.google.com/js/longlonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglong/main.js');
+
+ result.should.equal('http://www.google.com/js/longlonglonglonglonglo ... longlonglonglonglonglonglonglonglonglong/main.js');
+ });
+
+ });
+
+
+ describe('cssOffenderPattern', function() {
+
+ it('should transform a css offender into an object', function() {
+ var result = offendersHelpers.cssOffenderPattern('.pagination .plus ul li @ 30:31862');
+
+ result.should.deep.equal({
+ offender: '.pagination .plus ul li',
+ line: 30,
+ character: 31862
+ });
+ });
+
+ it('should handle the case where line and char are not here', function() {
+ var result = offendersHelpers.cssOffenderPattern('.pagination .plus ul li');
+
+ result.should.deep.equal({
+ offender: '.pagination .plus ul li'
+ });
+ });
+
+ });
+
});
From 4a8a5829d74834db3ce3ae9339fdde5460a90000 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Thu, 22 Jan 2015 14:54:51 +0100
Subject: [PATCH 14/54] End of the offender transform functions
---
lib/metadata/policies.js | 231 ++++++++++++++++++++++++++----
lib/offendersHelpers.js | 15 ++
test/core/offendersHelpersTest.js | 13 ++
3 files changed, 235 insertions(+), 24 deletions(-)
diff --git a/lib/metadata/policies.js b/lib/metadata/policies.js
index 82ce5b7..b6f2c35 100644
--- a/lib/metadata/policies.js
+++ b/lib/metadata/policies.js
@@ -510,7 +510,7 @@ var policies = {
return offenders.map(function(offender) {
var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
- var parts = /^([^{]*)(?: { ([^ ]+): (.*) }) \/\/ (.*)$/.exec(splittedOffender.offender);
+ var parts = /^([^{]*)(?: ?{ ?([^ ]+): (.*) ?}) \/\/ (.*)$/.exec(splittedOffender.offender);
if (!parts) {
debug('cssOldPropertyPrefixes offenders transform function error with "%s"', offender);
@@ -535,7 +535,17 @@ var policies = {
"message": "This is one way to remove complexity from a CSS rule. Generally, when \"body\" is specified in a rule it can be removed, because an element is necessarily inside the body.
",
"isOkThreshold": 0,
"isBadThreshold": 50,
- "isAbnormalThreshold": 200
+ "isAbnormalThreshold": 200,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+
+ var rule = splittedOffender.offender;
+ rule = rule.replace(/body/, 'body');
+
+ return rule + ' @ ' + splittedOffender.line + ':' + splittedOffender.character;
+ });
+ }
},
"cssRedundantChildNodesSelectors": {
"tool": "phantomas",
@@ -543,7 +553,27 @@ var policies = {
"message": "Some tags included inside other tags are obvious. For example, when \"ul li\" is specified in a rule, \"ul\" can be removed because the \"li\" element is always inside a \"ul\". Same thing for \"tr td\", \"select option\", ...
Lowering compexity in CSS selectors can make the page load a little faster.
",
"isOkThreshold": 0,
"isBadThreshold": 50,
- "isAbnormalThreshold": 200
+ "isAbnormalThreshold": 200,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+
+ var rule = splittedOffender.offender;
+ var redundanters = [
+ ['ul', 'li'],
+ ['ol', 'li'],
+ ['select', 'option'],
+ ['table', 'tr'],
+ ['table', 'th'],
+ ];
+
+ redundanters.forEach(function(couple) {
+ rule = rule.replace(new RegExp('(^| |>)' + couple[0] + '([^ >]*)?([ >]| > )' + couple[1] + '([^\\w-]|$)', 'g'), '$1' + couple[0] + '$2$3' + couple[1] + '$4');
+ });
+
+ return rule + ' @ ' + splittedOffender.line + ':' + splittedOffender.character;
+ });
+ }
},
"requests": {
"tool": "phantomas",
@@ -552,7 +582,17 @@ var policies = {
"isOkThreshold": 15,
"isBadThreshold": 100,
"isAbnormalThreshold": 200,
- "takeOffendersFrom": ["htmlCount", "jsCount", "cssCount", "imageCount", "webfontCount", "videoCount", "jsonCount", "jsonCount"]
+ "takeOffendersFrom": ["htmlCount", "jsCount", "cssCount", "imageCount", "webfontCount", "videoCount", "jsonCount", "jsonCount"],
+ "offendersTransformFn": function(offenders) {
+ return offenders
+ .map(function(offender) {
+ return offendersHelpers.fileWithSizePattern(offender);
+ }).sort(function(a, b) {
+ return b.size - a.size;
+ }).map(function(fileObj) {
+ return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
+ });
+ }
},
"htmlCount": {
"tool": "phantomas",
@@ -560,7 +600,13 @@ var policies = {
"message": "The number of HTML pages requests, HTML fragments or iframes.
",
"isOkThreshold": 10,
"isBadThreshold": 20,
- "isAbnormalThreshold": 30
+ "isAbnormalThreshold": 30,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var fileObj = offendersHelpers.fileWithSizePattern(offender);
+ return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
+ });
+ }
},
"jsCount": {
"tool": "phantomas",
@@ -568,7 +614,13 @@ var policies = {
"message": "Reduce the number of scripts by concatenating them.
",
"isOkThreshold": 5,
"isBadThreshold": 15,
- "isAbnormalThreshold": 30
+ "isAbnormalThreshold": 30,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var fileObj = offendersHelpers.fileWithSizePattern(offender);
+ return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
+ });
+ }
},
"cssCount": {
"tool": "phantomas",
@@ -576,7 +628,13 @@ var policies = {
"message": "Reduce the number of stylesheets by concatenating them.
",
"isOkThreshold": 3,
"isBadThreshold": 10,
- "isAbnormalThreshold": 22
+ "isAbnormalThreshold": 22,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var fileObj = offendersHelpers.fileWithSizePattern(offender);
+ return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
+ });
+ }
},
"imageCount": {
"tool": "phantomas",
@@ -584,7 +642,13 @@ var policies = {
"message": "Reduce the number of images by lazyloading them, by spriting them or by creating an icons font.
",
"isOkThreshold": 15,
"isBadThreshold": 40,
- "isAbnormalThreshold": 70
+ "isAbnormalThreshold": 70,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var fileObj = offendersHelpers.fileWithSizePattern(offender);
+ return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
+ });
+ }
},
"webfontCount": {
"tool": "phantomas",
@@ -592,15 +656,27 @@ var policies = {
"message": "Fonts are loaded on the critical path of the head. Load as many as possible.
",
"isOkThreshold": 0,
"isBadThreshold": 3,
- "isAbnormalThreshold": 5
+ "isAbnormalThreshold": 5,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var fileObj = offendersHelpers.fileWithSizePattern(offender);
+ return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
+ });
+ }
},
"videoCount": {
"tool": "phantomas",
- "label": "Videos count",
+ "label": "Video count",
"message": "The number of videos loaded.
",
"isOkThreshold": 1,
"isBadThreshold": 5,
- "isAbnormalThreshold": 15
+ "isAbnormalThreshold": 15,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var fileObj = offendersHelpers.fileWithSizePattern(offender);
+ return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
+ });
+ }
},
"jsonCount": {
"tool": "phantomas",
@@ -608,7 +684,13 @@ var policies = {
"message": "The number of AJAX requests to JSON files or webservices.
",
"isOkThreshold": 2,
"isBadThreshold": 10,
- "isAbnormalThreshold": 25
+ "isAbnormalThreshold": 25,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var fileObj = offendersHelpers.fileWithSizePattern(offender);
+ return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
+ });
+ }
},
"otherCount": {
"tool": "phantomas",
@@ -616,7 +698,13 @@ var policies = {
"message": "They can be Flash, XML, music or any unknown format.
",
"isOkThreshold": 5,
"isBadThreshold": 20,
- "isAbnormalThreshold": 40
+ "isAbnormalThreshold": 40,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var fileObj = offendersHelpers.fileWithSizePattern(offender);
+ return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
+ });
+ }
},
"smallJsFiles": {
"tool": "phantomas",
@@ -624,7 +712,13 @@ var policies = {
"message": "Number of JS assets smaller than 2 KB that could probably be inlined or merged.
",
"isOkThreshold": 2,
"isBadThreshold": 10,
- "isAbnormalThreshold": 16
+ "isAbnormalThreshold": 16,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var fileObj = offendersHelpers.fileWithSizePattern(offender);
+ return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
+ });
+ }
},
"smallCssFiles": {
"tool": "phantomas",
@@ -632,7 +726,13 @@ var policies = {
"message": "Number of CSS assets smaller than 2 KB that could probably be inlined or merged.
",
"isOkThreshold": 0,
"isBadThreshold": 8,
- "isAbnormalThreshold": 12
+ "isAbnormalThreshold": 12,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var fileObj = offendersHelpers.fileWithSizePattern(offender);
+ return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
+ });
+ }
},
"smallImages": {
"tool": "phantomas",
@@ -640,7 +740,13 @@ var policies = {
"message": "Images smaller than 2 KB that could be base64 encoded or merged into a sprite.
",
"isOkThreshold": 2,
"isBadThreshold": 17,
- "isAbnormalThreshold": 30
+ "isAbnormalThreshold": 30,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var fileObj = offendersHelpers.fileWithSizePattern(offender);
+ return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
+ });
+ }
},
"notFound": {
"tool": "phantomas",
@@ -648,7 +754,12 @@ var policies = {
"message": "404 errors are never cached, so each time a page ask for it, it hits se server. Even if it is behind a CDN or a reverse-proxy cache.
",
"isOkThreshold": 0,
"isBadThreshold": 1,
- "isAbnormalThreshold": 1
+ "isAbnormalThreshold": 1,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ return offendersHelpers.urlToLink(offender);
+ });
+ }
},
"closedConnections": {
"tool": "phantomas",
@@ -656,15 +767,25 @@ var policies = {
"message": "This counts the number of requests not keeping the connection alive (specifying \"Connection: close\" in the response headers). It is only counting a request if it is followed by another request on the same domain.
This is slowing down the next request, because the brower needs to open a new connection to the server, which means a additional round-trip.
Correct the problem by setting a Keep-Alive header on the guilty server.
",
"isOkThreshold": 0,
"isBadThreshold": 8,
- "isAbnormalThreshold": 20
+ "isAbnormalThreshold": 20,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ return offendersHelpers.urlToLink(offender);
+ });
+ }
},
"multipleRequests": {
"tool": "phantomas",
"label": "Duplicated requests",
"message": "This only happens when the asset has no cache and is requested more than once on the same page. Be very careful about it.
",
"isOkThreshold": 0,
- "isBadThreshold": 5,
- "isAbnormalThreshold": 10
+ "isBadThreshold": 3,
+ "isAbnormalThreshold": 10,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ return offendersHelpers.urlToLink(offender);
+ });
+ }
},
"cachingDisabled": {
"tool": "phantomas",
@@ -672,7 +793,12 @@ var policies = {
"message": "Counts responses with caching disabled (max-age=0)
Fix immediatly if on static assets.
",
"isOkThreshold": 0,
"isBadThreshold": 12,
- "isAbnormalThreshold": 25
+ "isAbnormalThreshold": 25,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ return offendersHelpers.urlToLink(offender);
+ });
+ }
},
"cachingNotSpecified": {
"tool": "phantomas",
@@ -680,7 +806,12 @@ var policies = {
"message": "When no caching is specified, each browser will handle it differently. Most of the time, it will automatically add a cache for you, but a poor one. You'd better handle it yourself.
",
"isOkThreshold": 5,
"isBadThreshold": 20,
- "isAbnormalThreshold": 40
+ "isAbnormalThreshold": 40,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ return offendersHelpers.urlToLink(offender);
+ });
+ }
},
"cachingTooShort": {
"tool": "phantomas",
@@ -688,7 +819,47 @@ var policies = {
"message": "Responses with too short caching time (less than a week).
The longer you cache, the better. Add versionning to your static assets, if it's not already done, and set their cache time to one year.
",
"isOkThreshold": 5,
"isBadThreshold": 20,
- "isAbnormalThreshold": 40
+ "isAbnormalThreshold": 40,
+ "offendersTransformFn": function(offenders) {
+ return offenders
+ .map(function(offender) {
+ var parts = /^([^ ]*) cached for (-?\d+(\.\d+)?) s$/.exec(offender);
+
+ if (!parts) {
+ debug('cachingTooShort offenders transform function error with "%s"', offender);
+ return {
+ file: offender
+ };
+ }
+
+ return {
+ file: parts[1],
+ ttl: Math.round(parseFloat(parts[2]))
+ };
+ }).sort(function(a, b) {
+ return a.ttl - b.ttl;
+ }).map(function(obj) {
+ var duration = obj.ttl;
+ var unit = 'seconds';
+
+ if (duration >= 120) {
+ duration = Math.round(duration / 60);
+ unit = 'minutes';
+ }
+
+ if (duration >= 120) {
+ duration = Math.round(duration / 60);
+ unit = 'hours';
+ }
+
+ if (duration >= 48) {
+ duration = Math.round(duration / 24);
+ unit = 'days';
+ }
+
+ return offendersHelpers.urlToLink(obj.file) + ' cached for ' + duration + ' ' + unit + '';
+ });
+ }
},
"domains": {
"tool": "phantomas",
@@ -696,7 +867,19 @@ var policies = {
"message": "For each domain met, the browser needs to make a DNS look-up, which is slow. Avoid having to many different domains and the page should render faster.
By the way, domain sharding is not a good practice anymore.
",
"isOkThreshold": 10,
"isBadThreshold": 25,
- "isAbnormalThreshold": 50
+ "isAbnormalThreshold": 50,
+ "offendersTransformFn": function(offenders) {
+ return offenders.map(function(offender) {
+ var parts = /^([^ ]*): (\d+) request\(s\)$/.exec(offender);
+
+ if (!parts) {
+ debug('domains offenders transform function error with "%s"', offender);
+ return offender;
+ }
+
+ return '' + parts[1] + ' (' + parts[2] + ' ' + ((parseInt(parts[2], 10) > 1) ? 'requests' : 'request') + ')';
+ });
+ }
}
};
diff --git a/lib/offendersHelpers.js b/lib/offendersHelpers.js
index 66b11f3..36151c6 100644
--- a/lib/offendersHelpers.js
+++ b/lib/offendersHelpers.js
@@ -172,6 +172,21 @@ var OffendersHelpers = function() {
}
};
+ this.fileWithSizePattern = function(fileWithSize) {
+ var parts = /^([^ ]*) \((\d+\.\d{2}) kB\)$/.exec(fileWithSize);
+
+ if (!parts) {
+ return {
+ file: fileWithSize
+ };
+ } else {
+ return {
+ file: parts[1],
+ size: parseFloat(parts[2])
+ };
+ }
+ };
+
};
module.exports = new OffendersHelpers();
\ No newline at end of file
diff --git a/test/core/offendersHelpersTest.js b/test/core/offendersHelpersTest.js
index 072d2d1..d6632f0 100644
--- a/test/core/offendersHelpersTest.js
+++ b/test/core/offendersHelpersTest.js
@@ -267,4 +267,17 @@ describe('offendersHelpers', function() {
});
+ describe('fileWithSizePattern', function() {
+
+ it('should return an object', function() {
+ var result = offendersHelpers.fileWithSizePattern('http://img3.pouet.com/2008/portail/js/jq-timer.js (1.72 kB)');
+
+ result.should.deep.equal({
+ file: 'http://img3.pouet.com/2008/portail/js/jq-timer.js',
+ size: 1.72
+ });
+ });
+
+ });
+
});
From ee666a3a6f707f5bc276ca1265beab1aaca506ac Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Thu, 22 Jan 2015 15:15:38 +0100
Subject: [PATCH 15/54] Temporary fix for negative ttl in cachingTooShort
---
.../custom_modules/modules/cachYLT/cachYLT.js | 79 +++++++++++++++++++
lib/tools/phantomas/phantomasWrapper.js | 1 +
2 files changed, 80 insertions(+)
create mode 100644 lib/tools/phantomas/custom_modules/modules/cachYLT/cachYLT.js
diff --git a/lib/tools/phantomas/custom_modules/modules/cachYLT/cachYLT.js b/lib/tools/phantomas/custom_modules/modules/cachYLT/cachYLT.js
new file mode 100644
index 0000000..213edfe
--- /dev/null
+++ b/lib/tools/phantomas/custom_modules/modules/cachYLT/cachYLT.js
@@ -0,0 +1,79 @@
+/**
+ * Analyzes HTTP caching headers
+ *
+ * @see https://developers.google.com/speed/docs/best-practices/caching
+ */
+
+exports.version = '0.2.a';
+
+exports.module = function(phantomas) {
+ 'use strict';
+
+ var cacheControlRegExp = /max-age=(\d+)/;
+
+ function getCachingTime(url, headers) {
+ // false means "no caching"
+ var ttl = false,
+ headerName,
+ now = new Date(),
+ headerDate;
+
+ for (headerName in headers) {
+ var value = headers[headerName];
+
+ switch (headerName.toLowerCase()) {
+ // parse max-age=...
+ //
+ // max-age=2592000
+ // public, max-age=300, must-revalidate
+ case 'cache-control':
+ var matches = value.match(cacheControlRegExp);
+
+ if (matches) {
+ ttl = parseInt(matches[1], 10);
+ }
+ break;
+
+ // catch Expires and Pragma headers
+ case 'expires':
+ case 'pragma':
+ // and Varnish specific headers
+ case 'x-pass-expires':
+ case 'x-pass-cache-control':
+ phantomas.incrMetric('oldCachingHeaders'); // @desc number of responses with old, HTTP 1.0 caching headers (Expires and Pragma)
+ phantomas.addOffender('oldCachingHeaders', url + ' - ' + headerName + ': ' + value);
+ headerDate = Date.parse(value);
+ if (headerDate) ttl = Math.round((headerDate - now) / 1000);
+ break;
+ }
+ }
+
+ //console.log(JSON.stringify(headers)); console.log("TTL: " + ttl + ' s');
+
+ return ttl;
+ }
+
+ phantomas.setMetric('cachingNotSpecified'); // @desc number of responses with no caching header sent (no Cache-Control header)
+ phantomas.setMetric('cachingTooShort'); // @desc number of responses with too short (less than a week) caching time
+ phantomas.setMetric('cachingDisabled'); // @desc number of responses with caching disabled (max-age=0)
+
+ phantomas.setMetric('oldCachingHeaders');
+
+ phantomas.on('recv', function(entry, res) {
+ var ttl = getCachingTime(entry.url, entry.headers);
+
+ // static assets
+ if (entry.isImage || entry.isJS || entry.isCSS) {
+ if (ttl === false) {
+ phantomas.incrMetric('cachingNotSpecified');
+ phantomas.addOffender('cachingNotSpecified', entry.url);
+ } else if (ttl <= 0) {
+ phantomas.incrMetric('cachingDisabled');
+ phantomas.addOffender('cachingDisabled', entry.url);
+ } else if (ttl < 7 * 86400) {
+ phantomas.incrMetric('cachingTooShort');
+ phantomas.addOffender('cachingTooShort', entry.url + ' cached for ' + ttl + ' s');
+ }
+ }
+ });
+};
diff --git a/lib/tools/phantomas/phantomasWrapper.js b/lib/tools/phantomas/phantomasWrapper.js
index 6c7937f..4706201 100644
--- a/lib/tools/phantomas/phantomasWrapper.js
+++ b/lib/tools/phantomas/phantomasWrapper.js
@@ -34,6 +34,7 @@ var PhantomasWrapper = function() {
'analyze-css': true,
'skip-modules': [
'blockDomains', // not needed
+ 'caching', // overriden
'domMutations', // not compatible with webkit
'domQueries', // overriden
'eventListeners', // overridden
From d829525ab8aa0a14ecb89728f8f6efd599048bec Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Mon, 26 Jan 2015 11:32:37 +0100
Subject: [PATCH 16/54] Update phantomas to v1.9
---
package.json | 3 +--
1 file changed, 1 insertion(+), 2 deletions(-)
diff --git a/package.json b/package.json
index fa04850..e2d31ec 100644
--- a/package.json
+++ b/package.json
@@ -16,7 +16,7 @@
"cors": "^2.5.2",
"debug": "~2.1.0",
"express": "~4.10.6",
- "phantomas": "1.8.0",
+ "phantomas": "1.9.0",
"ps-node": "0.0.3",
"q": "~1.1.2",
"rimraf": "~2.2.8"
@@ -44,7 +44,6 @@
"grunt-usemin": "^3.0.0",
"matchdep": "^0.3.0",
"mocha": "^2.1.0",
- "phantomjs": "^1.9.13",
"request": "^2.51.0",
"sinon": "^1.12.1",
"sinon-chai": "^2.6.0"
From 901116fde662e64b46deed737daefe9529f764e8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Mon, 26 Jan 2015 11:34:38 +0100
Subject: [PATCH 17/54] Separate offender analyze, parsing in the core, display
in the front
---
front/src/css/rule.css | 7 +-
front/src/js/app.js | 1 +
front/src/js/controllers/ruleCtrl.js | 4 -
.../src/js/directives/offendersDirectives.js | 120 +++
front/src/less/rule.less | 6 +-
front/src/main.html | 1 +
front/src/views/domElementButton.html | 7 +
front/src/views/rule.html | 141 ++-
lib/metadata/policies.js | 848 +++++++++++-------
lib/offendersHelpers.js | 102 +--
lib/rulesChecker.js | 88 +-
lib/tools/phantomas/phantomasWrapper.js | 3 +-
test/core/customPoliciesTest.js | 396 +++++++-
test/core/indexTest.js | 13 +-
test/core/offendersHelpersTest.js | 198 ++--
test/fixtures/rulesCheckerOutput.json | 36 +-
test/fixtures/rulesCheckerPolicies.js | 28 +-
17 files changed, 1436 insertions(+), 563 deletions(-)
create mode 100644 front/src/js/directives/offendersDirectives.js
create mode 100644 front/src/views/domElementButton.html
diff --git a/front/src/css/rule.css b/front/src/css/rule.css
index 80474b4..b66c470 100644
--- a/front/src/css/rule.css
+++ b/front/src/css/rule.css
@@ -120,17 +120,18 @@
.offenders .offenderButton .domTree > div div {
margin-left: 1em;
}
-.offenders .offenderButton .backtrace {
+.offenders .offenderButton .backtrace,
+.offenders .offenderButton .cssFileAndLine {
white-space: nowrap;
padding: 0.5em;
}
-.offenders .offenderButton:hover {
+.offenders .offenderButton.opens.mouseOver {
border-bottom-left-radius: 0;
border-bottom-right-radius: 0;
background: #ffe0cc;
z-index: 2;
}
-.offenders .offenderButton:hover > div {
+.offenders .offenderButton.opens.mouseOver > div {
display: block;
}
.offendersHtml {
diff --git a/front/src/js/app.js b/front/src/js/app.js
index 0adc65f..7ddabb4 100644
--- a/front/src/js/app.js
+++ b/front/src/js/app.js
@@ -11,6 +11,7 @@ var yltApp = angular.module('YellowLabTools', [
'resultsFactory',
'menuService',
'gradeDirective',
+ 'offendersDirectives'
]);
yltApp.run(['$rootScope', '$location', function($rootScope, $location) {
diff --git a/front/src/js/controllers/ruleCtrl.js b/front/src/js/controllers/ruleCtrl.js
index e63adc1..7ff0622 100644
--- a/front/src/js/controllers/ruleCtrl.js
+++ b/front/src/js/controllers/ruleCtrl.js
@@ -22,10 +22,6 @@ ruleCtrl.controller('RuleCtrl', ['$scope', '$rootScope', '$routeParams', '$locat
function init() {
$scope.rule = $scope.result.rules[$scope.policyName];
-
- if (angular.isString($scope.rule.offenders)) {
- $scope.htmlOffenders = $scope.rule.offenders;
- }
}
$scope.backToDashboard = function() {
diff --git a/front/src/js/directives/offendersDirectives.js b/front/src/js/directives/offendersDirectives.js
new file mode 100644
index 0000000..cb691d0
--- /dev/null
+++ b/front/src/js/directives/offendersDirectives.js
@@ -0,0 +1,120 @@
+var offendersDirectives = angular.module('offendersDirectives', []);
+
+offendersDirectives.directive('domTree', function() {
+ return {
+ restrict: 'E',
+ scope: {
+ tree: '='
+ },
+ template: '',
+ replace: true,
+ link: function(scope, element, attrs) {
+
+ function recursiveHtmlBuilder(tree) {
+ var html = '';
+ var keys = Object.keys(tree);
+
+ keys.forEach(function(key) {
+ if (isNaN(tree[key])) {
+ html += '' + key + '' + recursiveHtmlBuilder(tree[key]) + '
';
+ } else if (tree[key] > 1) {
+ html += '' + key + ' (x' + tree[key] + ')
';
+ } else {
+ html += '' + key + '
';
+ }
+ });
+
+ return html;
+ }
+
+ element.append(recursiveHtmlBuilder(scope.tree));
+ }
+ };
+});
+
+offendersDirectives.directive('domElementButton', function() {
+ return {
+ restrict: 'E',
+ scope: {
+ obj: '='
+ },
+ templateUrl: 'views/domElementButton.html',
+ replace: true
+ };
+});
+
+offendersDirectives.filter('shortenUrl', function() {
+ return function(url, maxLength) {
+ if (!maxLength) {
+ maxLength = 110;
+ }
+
+ // Why dividing by 2.1? Because it adds a 5% margin.
+ var leftLength = Math.floor((maxLength - 5) / 2.1);
+ var rightLength = Math.ceil((maxLength - 5) / 2.1);
+
+ return (url.length > maxLength) ? url.substr(0, leftLength) + ' ... ' + url.substr(-rightLength) : url;
+ };
+});
+
+offendersDirectives.directive('urlLink', function() {
+ return {
+ restrict: 'E',
+ scope: {
+ url: '=',
+ maxLength: '='
+ },
+ template: '{{url | shortenUrl:maxLength}}',
+ replace: true
+ };
+});
+
+offendersDirectives.filter('encodeURIComponent', function() {
+ return window.encodeURIComponent;
+});
+
+offendersDirectives.directive('fileAndLine', function() {
+ return {
+ restrict: 'E',
+ scope: {
+ file: '=',
+ line: '=',
+ column: '='
+ },
+ template: '<inline CSS> @ {{line}}:{{column}}',
+ replace: true
+ };
+});
+
+offendersDirectives.directive('fileAndLineButton', function() {
+ return {
+ restrict: 'E',
+ scope: {
+ file: '=',
+ line: '=',
+ column: '='
+ },
+ template: '',
+ replace: true
+ };
+});
+
+offendersDirectives.directive('offenderButton', function() {
+ return {
+ restrict: 'C',
+ link: function(scope, element, attrs) {
+
+ console.log('initializing touchstart');
+
+ element.bind('touchstart mouseenter', function(e) {
+ element.addClass('mouseOver');
+ e.preventDefault();
+ });
+
+ element.bind('touchend mouseleave click', function(e) {
+ element.removeClass('mouseOver');
+ e.preventDefault();
+ });
+ }
+ };
+});
\ No newline at end of file
diff --git a/front/src/less/rule.less b/front/src/less/rule.less
index 71bb103..ccf862a 100644
--- a/front/src/less/rule.less
+++ b/front/src/less/rule.less
@@ -135,18 +135,18 @@
}
}
- .backtrace {
+ .backtrace, .cssFileAndLine {
white-space: nowrap;
padding: 0.5em;
}
- &:hover {
+ &.opens.mouseOver {
border-bottom-left-radius: 0;
border-bottom-right-radius: 0;
background: #ffe0cc;
z-index: 2;
- & > div {
+ > div {
display: block;
}
}
diff --git a/front/src/main.html b/front/src/main.html
index 88f1dd6..fe5ec86 100644
--- a/front/src/main.html
+++ b/front/src/main.html
@@ -32,6 +32,7 @@
+
diff --git a/front/src/views/domElementButton.html b/front/src/views/domElementButton.html
new file mode 100644
index 0000000..78dda24
--- /dev/null
+++ b/front/src/views/domElementButton.html
@@ -0,0 +1,7 @@
+
+ {{obj.type}}
+ DOM element {{obj.element}}
+ Fragment element {{obj.element}}
+ Created element {{obj.element}}
+
+
\ No newline at end of file
diff --git a/front/src/views/rule.html b/front/src/views/rule.html
index 639ed91..28e3c31 100644
--- a/front/src/views/rule.html
+++ b/front/src/views/rule.html
@@ -17,23 +17,134 @@
Warning
This rule reached the abnormality threshold, which means there is a real problem you should care about.
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+ {{offender.parseError}}
+
+
+
+
+ {{offender.id}}: {{offender.occurrences}} occurrences
+
+
+
+ appended to
+
+
+
+ {{offender.query}} (in ) using {{offender.fn}}
+
+
+
+ {{offender.query}} (in ) using {{offender.fn}}: {{offender.count}} queries
+
+
+
+ {{offender.eventName}} bound to
+
+
+
+
{{offender.error}}
+
no backtrace
+
+
+
+
+
+
+
+ {{offender.css}}
+
+
+
+
+ {{offender.rule}} (x{{offender.occurrences}})
+
+
+
+ Property {{offender.property}} duplicated in {{offender.rule}} { }
+
+
+
+
+ {{offender.css}} { }
+
+
+
+
+ {{offender.rule}} {{ '{' + offender.property}}: expression({{offender.expression}})}
+
+
+
+
+ {{offender.rule}} {{ '{' + offender.property}}: {{offender.value}} !important}
+
+
+
+
+ {{offender.browser}} fix:
+
+
+
+
+
+ {{offender.rule}} {{{offender.property}}: {{offender.value + '}' }}
+
+
+
+
+
+ ({{offender.size}} kB)
+
+
+
+
+
+
+
+
+ cached for {{offender.ttlWithUnit}} {{offender.unit}}
+
+
+
+ {{offender.domain}}
+ ()
+
+
+
+ {{offender}}
+
+
+
-
-
404
diff --git a/lib/metadata/policies.js b/lib/metadata/policies.js
index b6f2c35..00e667b 100644
--- a/lib/metadata/policies.js
+++ b/lib/metadata/policies.js
@@ -8,7 +8,8 @@ var policies = {
"message": "
A high number of DOM elements means a lot of work for the browser to render the page.
It also slows down JavaScript DOM queries, as there are more elements to search through.
",
"isOkThreshold": 1000,
"isBadThreshold": 2500,
- "isAbnormalThreshold": 4000
+ "isAbnormalThreshold": 4000,
+ "hasOffenders": false
},
"DOMelementMaxDepth": {
"tool": "phantomas",
@@ -17,8 +18,14 @@ var policies = {
"isOkThreshold": 10,
"isBadThreshold": 20,
"isAbnormalThreshold": 28,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offendersHelpers.listOfDomPathsToHTML(offenders);
+ var domArrays = offenders.map(offendersHelpers.domPathToArray);
+
+ return {
+ count: offenders.length,
+ tree: offendersHelpers.listOfDomArraysToTree(domArrays)
+ };
}
},
"iframesCount": {
@@ -27,7 +34,8 @@ var policies = {
"message": "
iFrames are the most complex HTML elements. They are pages, just like the main page, and the browser needs to create a new page context, which has a cost.
",
"isOkThreshold": 2,
"isBadThreshold": 15,
- "isAbnormalThreshold": 30
+ "isAbnormalThreshold": 30,
+ "hasOffenders": false
},
"DOMidDuplicated": {
"tool": "phantomas",
@@ -36,17 +44,26 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 5,
"isAbnormalThreshold": 10,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var parts = /^(.*): ?(\d+) ?occurrences$/.exec(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var parts = /^(.*): ?(\d+) ?occurrences$/.exec(offender);
- if (!parts) {
- debug('DOMidDuplicated offenders transform function error with "%s"', offender);
- return offender;
- }
+ if (!parts) {
+ debug('DOMidDuplicated offenders transform function error with "%s"', offender);
+ return {
+ parseError: offender
+ };
+ }
- return '
#' + parts[1] + ': ' + parts[2] + ' occurrences';
- });
+ return {
+ id: parts[1],
+ occurrences: parseInt(parts[2], 10)
+ };
+ })
+ };
}
},
"DOMinserts": {
@@ -56,17 +73,26 @@ var policies = {
"isOkThreshold": 10,
"isBadThreshold": 400,
"isAbnormalThreshold": 1000,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var parts = /^"(.*)" ?appended ?to ?"(.*)"$/.exec(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var parts = /^"(.*)" ?appended ?to ?"(.*)"$/.exec(offender);
- if (!parts) {
- debug('DOMinserts offenders transform function error with "%s"', offender);
- return offender;
- }
+ if (!parts) {
+ debug('DOMinserts offenders transform function error with "%s"', offender);
+ return {
+ parseError: offender
+ };
+ }
- return offendersHelpers.domPathToButton(parts[1]) + ' appended to ' + offendersHelpers.domPathToButton(parts[2]);
- });
+ return {
+ insertedElement: offendersHelpers.domPathToDomElementObj(parts[1]),
+ receiverElement: offendersHelpers.domPathToDomElementObj(parts[2])
+ };
+ })
+ };
}
},
"DOMqueries": {
@@ -75,7 +101,8 @@ var policies = {
"message": "
DOM queries are like looking in a large catalog of items. Even if the browsers made progress on the performances of queries, websites often make hundreds of them.
Try to reduce the number of queries by refactoring your JavaScript code.
Avoid also to have a read query between two write queries. To be able to reduce the number repaints and optimize performances, browsers buffer the DOM writing operations and treat them in bulk. But each time a DOM reading is asked, the browser needs to empty the buffer. This can be particularly slow inside a loop.
",
"isOkThreshold": 50,
"isBadThreshold": 1000,
- "isAbnormalThreshold": 2000
+ "isAbnormalThreshold": 2000,
+ "hasOffenders": false
},
"DOMqueriesWithoutResults": {
"tool": "phantomas",
@@ -84,17 +111,27 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 100,
"isAbnormalThreshold": 200,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var parts = /^(.*) ?\(in ?(.*)\) ?using ?(.*)$/.exec(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var parts = /^(.*) ?\(in ?(.*)\) ?using ?(.*)$/.exec(offender);
- if (!parts) {
- debug('DOMqueriesWithoutResults offenders transform function error with "%s"', offender);
- return offender;
- }
+ if (!parts) {
+ debug('DOMqueriesWithoutResults offenders transform function error with "%s"', offender);
+ return {
+ parseError: offender
+ };
+ }
- return '
' + parts[1] + ' (in ' + offendersHelpers.domPathToButton(parts[2]) + ') using ' + parts[3];
- });
+ return {
+ query: parts[1],
+ context: offendersHelpers.domPathToDomElementObj(parts[2]),
+ fn: parts[3]
+ };
+ })
+ };
}
},
"DOMqueriesAvoidable": {
@@ -104,18 +141,29 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 200,
"isAbnormalThreshold": 500,
+ "hasOffenders": true,
"takeOffendersFrom": "DOMqueriesDuplicated",
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var parts = /^[^"]* ?"(.*)" ?with ?(.*) ?\(in ?context ?(.*)\): ?(.*)\s?queries$/.exec(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var parts = /^[^"]* ?"(.*)" ?with ?(.*) ?\(in ?context ?(.*)\): ?(.*)\s?queries$/.exec(offender);
- if (!parts) {
- debug('DOMqueriesAvoidable offenders transform function error with "%s"', offender);
- return offender;
- }
+ if (!parts) {
+ debug('DOMqueriesAvoidable offenders transform function error with "%s"', offender);
+ return {
+ parseError: offender
+ };
+ }
- return '
' + parts[1] + ' (in ' + offendersHelpers.domPathToButton(parts[3]) + ') using ' + parts[2] + ':
' + parts[4] + ' queries';
- });
+ return {
+ query: parts[1],
+ context: offendersHelpers.domPathToDomElementObj(parts[3]),
+ fn: parts[2],
+ count: parseInt(parts[4], 10)
+ };
+ })
+ };
}
},
"eventsBound": {
@@ -125,17 +173,26 @@ var policies = {
"isOkThreshold": 100,
"isBadThreshold": 800,
"isAbnormalThreshold": 1500,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var parts = /^"(.*)" ?bound ?to ?"(.*)"$/.exec(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var parts = /^"(.*)" ?bound ?to ?"(.*)"$/.exec(offender);
- if (!parts) {
- debug('eventsBound offenders transform function error with "%s"', offender);
- return offender;
- }
+ if (!parts) {
+ debug('eventsBound offenders transform function error with "%s"', offender);
+ return {
+ parseError: offender
+ };
+ }
- return '
' + parts[1] + ' bound to ' + offendersHelpers.domPathToButton(parts[2]);
- });
+ return {
+ eventName: parts[1],
+ element: offendersHelpers.domPathToDomElementObj(parts[2])
+ };
+ })
+ };
}
},
"jsErrors": {
@@ -145,22 +202,28 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 1,
"isAbnormalThreshold": 4,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var parts = /^(.*) - (.*)$/.exec(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var parts = /^(.*) - (.*)$/.exec(offender);
- if (!parts) {
- debug('jsErrors offenders transform function error with "%s"', offender);
- return offender;
- }
+ if (!parts) {
+ debug('jsErrors offenders transform function error with "%s"', offender);
+ return {
+ parseError: offender
+ };
+ }
- var backtraceArray = offendersHelpers.backtraceToArray(parts[2]);
- if (backtraceArray === null) {
- return offender;
- } else {
- return '
' + parts[1] + ' ' + offendersHelpers.backtraceArrayToHtml(backtraceArray);
- }
- });
+ var backtraceArray = offendersHelpers.backtraceToArray(parts[2]);
+
+ return {
+ error: parts[1],
+ backtrace: backtraceArray || []
+ };
+ })
+ };
}
},
"evalCalls": {
@@ -169,7 +232,8 @@ var policies = {
"message": "
The 'eval' function is slow and is a bad coding practice. Try to get rid of it.
",
"isOkThreshold": 0,
"isBadThreshold": 10,
- "isAbnormalThreshold": 20
+ "isAbnormalThreshold": 20,
+ "hasOffenders": false
},
"documentWriteCalls": {
"tool": "phantomas",
@@ -177,7 +241,8 @@ var policies = {
"message": "
They slow down the page construction, especially if they are used to insert scripts in the page. Remove them ASAP.
If you cannot remove them because they come from a third-party script (such as ads), have a look at PostScribe.
",
"isOkThreshold": 0,
"isBadThreshold": 10,
- "isAbnormalThreshold": 20
+ "isAbnormalThreshold": 20,
+ "hasOffenders": false
},
"consoleMessages": {
"tool": "phantomas",
@@ -185,7 +250,8 @@ var policies = {
"message": "
Try to keep your console clean when in production. Debugging is good for development only.
Writing in the console has a cost, especially when dumping large object variables.
There is also a problem with Internet Explorer 8, not knowing the console object.
",
"isOkThreshold": 0,
"isBadThreshold": 10,
- "isAbnormalThreshold": 25
+ "isAbnormalThreshold": 25,
+ "hasOffenders": false
},
"globalVariables": {
"tool": "phantomas",
@@ -194,17 +260,22 @@ var policies = {
"isOkThreshold": 10,
"isBadThreshold": 50,
"isAbnormalThreshold": 200,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offendersHelpers.sortVarsLikeChromeDevTools(offenders);
+ return {
+ count: offenders.length,
+ list: offendersHelpers.sortVarsLikeChromeDevTools(offenders)
+ };
}
},
"jQueryVersion": {
"label": "jQuery version",
"message": "
Current latest versions of jQuery are 1.11 (with support for old IE versions) and 2.1 (without).
Each new version of jQuery optimizes performances. Do not keep an old version of jQuery. Updating can sometimes break a few things, but it is generally quite easy to fix them up. So don't hesitate.
",
+ "hasOffenders": false,
"scoreFn": function(data) {
var differentVersions = data.toolsResults.phantomas.metrics.jQueryDifferentVersions;
- if (differentVersions === 0 || differentVersions > 1) {
+ if (differentVersions === 0 || differentVersions > 1 || !data.toolsResults.phantomas.metrics.jQueryVersion) {
// Not applicable
return null;
} else {
@@ -257,7 +328,8 @@ var policies = {
"message": "
jQuery is a heavy library. You should never load jQuery more than once on the same page.
",
"isOkThreshold": 1,
"isBadThreshold": 2,
- "isAbnormalThreshold": 2
+ "isAbnormalThreshold": 2,
+ "hasOffenders": true
},
"cssParsingErrors": {
"tool": "phantomas",
@@ -266,32 +338,28 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 1,
"isAbnormalThreshold": 1,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var parts = /^(([^ \(]*|
) ?)?(?:\((((?! @ ).)*)( @ (\d+):(\d+))?\))?$/.exec(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var parts = /^(?:(?:<([^ \(]*)>|\[inline CSS\]) ?)?(?:\((((?! @ ).)*)(?: @ (\d+):(\d+))?\))?$/.exec(offender);
- if (!parts) {
- debug('cssParsingErrors offenders transform function error with "%s"', offender);
- return offender;
- }
+ if (!parts) {
+ debug('cssParsingErrors offenders transform function error with "%s"', offender);
+ return {
+ parseError: offender
+ };
+ }
- var html = (parts[3]) ? parts[3] : '';
-
- if (parts[2]) {
- html += (parts[2] === '') ? ' <inline CSS>' : ' ' + offendersHelpers.urlToLink(parts[2]);
- }
-
- if (parts[5]) {
- html += ' @ ' + parts[6] + ':' + parts[7];
- }
-
- if (parts[2] && parts[2] !== '') {
- var w3cDirectUrl = 'http://jigsaw.w3.org/css-validator/validator?uri=' + encodeURIComponent(parts[2]) + '&profile=css3&usermedium=all&warning=no';
- html += ' (Check on the W3C validator)';
- }
-
- return html;
- });
+ return {
+ error: parts[2],
+ file: parts[1] || null,
+ line: (parts[4] && parts[5]) ? parseInt(parts[4], 10) : null,
+ column: (parts[4] && parts[5]) ? parseInt(parts[5], 10) : null
+ };
+ })
+ };
}
},
"cssRules": {
@@ -300,7 +368,8 @@ var policies = {
"message": "Having a huge number of CSS rules hurts performances. If the number of CSS rules is higher than the number of DOM elements, there is clearly a problem.
Huge stylesheets generally occur when the different pages of a website load all the CSS, concatenated in a single stylesheet, even if a large part of the rules are page-specific. Solution is to create one main CSS file with global rules and one custom files per page.
",
"isOkThreshold": 500,
"isBadThreshold": 2500,
- "isAbnormalThreshold": 4000
+ "isAbnormalThreshold": 4000,
+ "hasOffenders": false
},
"cssComplexSelectors": {
"tool": "phantomas",
@@ -309,12 +378,15 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 500,
"isAbnormalThreshold": 2000,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
-
- return '' + splittedOffender.offender + ' @ ' + splittedOffender.line + ':' + splittedOffender.character;
- });
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+ return splittedOffender;
+ })
+ };
}
},
"cssComplexSelectorsByAttribute": {
@@ -324,14 +396,18 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 50,
"isAbnormalThreshold": 100,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
- var boldedOffender = splittedOffender.offender.replace(/(\[[^ ]+[~\|\^\$\*]="[^"]+"\])/g, '$1');
+ splittedOffender.bolded = splittedOffender.css.replace(/(\[[^ ]+[~\|\^\$\*]="[^"]+"\])/g, '$1');
- return boldedOffender + ' @ ' + splittedOffender.line + ':' + splittedOffender.character;
- });
+ return splittedOffender;
+ })
+ };
}
},
"cssImports": {
@@ -341,12 +417,15 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 1,
"isAbnormalThreshold": 1,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
-
- return '' + splittedOffender.offender + ' @ ' + splittedOffender.line + ':' + splittedOffender.character;
- });
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+ return splittedOffender;
+ })
+ };
}
},
"cssDuplicatedSelectors": {
@@ -356,17 +435,26 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 40,
"isAbnormalThreshold": 80,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var parts = /^(.*) \((\d+) times\)$/.exec(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var parts = /^(.*) \((\d+) times\)$/.exec(offender);
- if (!parts) {
- debug('cssDuplicatedSelectors offenders transform function error with "%s"', offender);
- return offender;
- }
+ if (!parts) {
+ debug('cssDuplicatedSelectors offenders transform function error with "%s"', offender);
+ return {
+ parseError: offender
+ };
+ }
- return parts[1] + ' (x' + parts[2] + ')';
- });
+ return {
+ rule: parts[1],
+ occurrences: parseInt(parts[2], 10)
+ };
+ })
+ };
}
},
"cssDuplicatedProperties": {
@@ -376,19 +464,31 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 50,
"isAbnormalThreshold": 100,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
- var parts = /^([^{]+) {([^ ]+): (.+)}$/.exec(splittedOffender.offender);
+ var parts = /^([^{]+) {([^ ]+): (.+)}$/.exec(splittedOffender.css);
- if (!parts) {
- debug('cssDuplicatedProperties offenders transform function error with "%s"', offender);
- return offender;
- }
+ if (!parts) {
+ debug('cssDuplicatedProperties offenders transform function error with "%s"', offender);
+ return {
+ parseError: offender
+ };
+ }
- return 'Property ' + parts[2] + ' duplicated in ' + parts[1] + ' { } @ ' + splittedOffender.line + ':' + splittedOffender.character;
- });
+ return {
+ property: parts[2],
+ rule: parts[1],
+ file: splittedOffender.file,
+ line: splittedOffender.line,
+ column: splittedOffender.column
+ };
+ })
+ };
}
},
"cssEmptyRules": {
@@ -398,11 +498,16 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 40,
"isAbnormalThreshold": 100,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
- return '' + splittedOffender.offender + ' { } @ ' + splittedOffender.line + ':' + splittedOffender.character;
- });
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+
+ return splittedOffender;
+ })
+ };
}
},
"cssExpressions": {
@@ -412,19 +517,32 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 1,
"isAbnormalThreshold": 20,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
- var parts = /^(.*) {([^ ]+): expression\((.*)\)}$/.exec(splittedOffender.offender);
+ var parts = /^(.*) {([^ ]+): expression\((.*)\)}$/.exec(splittedOffender.css);
- if (!parts) {
- debug('cssExpressions offenders transform function error with "%s"', offender);
- return offender;
- }
+ if (!parts) {
+ debug('cssExpressions offenders transform function error with "%s"', offender);
+ return {
+ parseError: offender
+ };
+ }
- return parts[1] + ' {' + parts[2] + ': expression(' + parts[3] + ')} @ ' + splittedOffender.line + ':' + splittedOffender.character;
- });
+ return {
+ rule: parts[1],
+ property: parts[2],
+ expression: parts[3],
+ file: splittedOffender.file,
+ line: splittedOffender.line,
+ column: splittedOffender.column
+ };
+ })
+ };
}
},
"cssImportants": {
@@ -434,19 +552,32 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 50,
"isAbnormalThreshold": 150,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
- var parts = /^(.*) {([^ ]+): (.*) ?\!important}$/.exec(splittedOffender.offender);
+ var parts = /^(.*) {([^ ]+): (.*) ?\!important}$/.exec(splittedOffender.css);
- if (!parts) {
- debug('cssImportants offenders transform function error with "%s"', offender);
- return offender;
- }
+ if (!parts) {
+ debug('cssImportants offenders transform function error with "%s"', offender);
+ return {
+ parseError: offender
+ };
+ }
- return parts[1] + ' {' + parts[2] + ': ' + parts[3] + ' !important} @ ' + splittedOffender.line + ':' + splittedOffender.character;
- });
+ return {
+ rule: parts[1],
+ property: parts[2],
+ value: parts[3],
+ file: splittedOffender.file,
+ line: splittedOffender.line,
+ column: splittedOffender.column
+ };
+ })
+ };
}
},
"cssOldIEFixes": {
@@ -456,47 +587,54 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 50,
"isAbnormalThreshold": 300,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
- var parts = /^([^{]*)( {([^ ]+): (.*)})?$/.exec(splittedOffender.offender);
+ var parts = /^([^{]*)( {([^ ]+): (.*)})?$/.exec(splittedOffender.css);
- if (!parts) {
- debug('cssOldIEFixes offenders transform function error with "%s"', offender);
- return offender;
- }
+ if (!parts) {
+ debug('cssOldIEFixes offenders transform function error with "%s"', offender);
+ return {
+ parseError: offender
+ };
+ }
- var rule = parts[1];
- var property = parts[3];
- var value = parts[4];
- var browser = null;
+ var rule = parts[1];
+ var property = parts[3];
+ var value = parts[4];
+ var browser = null;
- if (rule.indexOf('* html') === 0) {
- rule = rule.replace(/^\* html/, '* html');
- browser = 'IE6';
- } else if (rule.indexOf('html>body') === 0) {
- rule = rule.replace(/^html>body/, 'html>body');
- browser = 'IE6';
- } else if (property.indexOf('*') === 0) {
- property = '' + property + '';
- browser = 'IE7';
- } else if (value.match(/\!ie$/)) {
- value = value.replace(/\!ie$/, '!ie');
- browser = 'IE7';
- } else if (property === '-ms-filter') {
- property = '-ms-filter';
- browser = 'IE9';
- } else if (value.indexOf('progid:DXImageTransform.Microsoft') === 0) {
- value = value.replace(/^progid:DXImageTransform\.Microsoft/, 'progid:DXImageTransform.Microsoft');
- browser = 'IE9';
- }
+ if (rule.indexOf('* html') === 0) {
+ rule = rule.replace(/^\* html/, '* html');
+ browser = 'IE6';
+ } else if (rule.indexOf('html>body') === 0) {
+ rule = rule.replace(/^html>body/, 'html>body');
+ browser = 'IE6';
+ } else if (property.indexOf('*') === 0) {
+ property = '' + property + '';
+ browser = 'IE7';
+ } else if (value.match(/\!ie$/)) {
+ value = value.replace(/\!ie$/, '!ie');
+ browser = 'IE7';
+ } else if (property === '-ms-filter') {
+ property = '-ms-filter';
+ browser = 'IE9';
+ } else if (value.indexOf('progid:DXImageTransform.Microsoft') >= 0) {
+ value = value.replace(/progid:DXImageTransform\.Microsoft/, 'progid:DXImageTransform.Microsoft');
+ browser = 'IE9';
+ }
- browser = browser ? '' + browser + ' fix: ' : '';
- var propertyAndValue = (property && value) ? ' {' + property + ': ' + value + '}' : '';
+ var propertyAndValue = (property && value) ? ' {' + property + ': ' + value + '}' : '';
+ splittedOffender.bolded = rule + propertyAndValue;
+ splittedOffender.browser = browser;
- return browser + rule + propertyAndValue + ' @ ' + splittedOffender.line + ':' + splittedOffender.character;
- });
+ return splittedOffender;
+ })
+ };
}
},
"cssOldPropertyPrefixes": {
@@ -506,19 +644,32 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 50,
"isAbnormalThreshold": 300,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
- var parts = /^([^{]*)(?: ?{ ?([^ ]+): (.*) ?}) \/\/ (.*)$/.exec(splittedOffender.offender);
+ var parts = /^([^{]*)(?: ?{ ?([^ ]+): (.*) ?}) \/\/ (.*)$/.exec(splittedOffender.css);
- if (!parts) {
- debug('cssOldPropertyPrefixes offenders transform function error with "%s"', offender);
- return offender;
- }
+ if (!parts) {
+ debug('cssOldPropertyPrefixes offenders transform function error with "%s"', offender);
+ return {
+ parseError: offender
+ };
+ }
- return '' + parts[1] + ' {' + parts[2] + ': ' + parts[3] + '} @ ' + splittedOffender.line + ':' + splittedOffender.character + '
' + parts[4] + '
';
- });
+ return {
+ rule: parts[1],
+ property: parts[2],
+ value: parts[3],
+ file: splittedOffender.file,
+ line: splittedOffender.line,
+ column: splittedOffender.column
+ };
+ })
+ };
}
},
"cssUniversalSelectors": {
@@ -527,7 +678,17 @@ var policies = {
"message": "Universal selectors are the most expensive CSS selectors.
More informations here.
",
"isOkThreshold": 0,
"isBadThreshold": 40,
- "isAbnormalThreshold": 150
+ "isAbnormalThreshold": 150,
+ "hasOffenders": true,
+ "offendersTransformFn": function(offenders) {
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+ return splittedOffender;
+ })
+ };
+ }
},
"cssRedundantBodySelectors": {
"tool": "phantomas",
@@ -536,15 +697,18 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 50,
"isAbnormalThreshold": 200,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
- var rule = splittedOffender.offender;
- rule = rule.replace(/body/, 'body');
+ splittedOffender.bolded = splittedOffender.css.replace(/body/, 'body');
- return rule + ' @ ' + splittedOffender.line + ':' + splittedOffender.character;
- });
+ return splittedOffender;
+ })
+ };
}
},
"cssRedundantChildNodesSelectors": {
@@ -554,25 +718,31 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 50,
"isAbnormalThreshold": 200,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var splittedOffender = offendersHelpers.cssOffenderPattern(offender);
- var rule = splittedOffender.offender;
- var redundanters = [
- ['ul', 'li'],
- ['ol', 'li'],
- ['select', 'option'],
- ['table', 'tr'],
- ['table', 'th'],
- ];
+ var rule = splittedOffender.css;
+ var redundanters = [
+ ['ul', 'li'],
+ ['ol', 'li'],
+ ['select', 'option'],
+ ['table', 'tr'],
+ ['table', 'th'],
+ ];
- redundanters.forEach(function(couple) {
- rule = rule.replace(new RegExp('(^| |>)' + couple[0] + '([^ >]*)?([ >]| > )' + couple[1] + '([^\\w-]|$)', 'g'), '$1' + couple[0] + '$2$3' + couple[1] + '$4');
- });
+ redundanters.forEach(function(couple) {
+ rule = rule.replace(new RegExp('(^| |>)' + couple[0] + '([^ >]*)?([ >]| > )' + couple[1] + '([^\\w-]|$)', 'g'), '$1' + couple[0] + '$2$3' + couple[1] + '$4');
+ });
- return rule + ' @ ' + splittedOffender.line + ':' + splittedOffender.character;
- });
+ splittedOffender.bolded = rule;
+
+ return splittedOffender;
+ })
+ };
}
},
"requests": {
@@ -582,16 +752,18 @@ var policies = {
"isOkThreshold": 15,
"isBadThreshold": 100,
"isAbnormalThreshold": 200,
+ "hasOffenders": true,
"takeOffendersFrom": ["htmlCount", "jsCount", "cssCount", "imageCount", "webfontCount", "videoCount", "jsonCount", "jsonCount"],
"offendersTransformFn": function(offenders) {
- return offenders
- .map(function(offender) {
- return offendersHelpers.fileWithSizePattern(offender);
- }).sort(function(a, b) {
- return b.size - a.size;
- }).map(function(fileObj) {
- return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
- });
+ return {
+ count: offenders.length,
+ list: offenders
+ .map(function(offender) {
+ return offendersHelpers.fileWithSizePattern(offender);
+ }).sort(function(a, b) {
+ return b.size - a.size;
+ })
+ };
}
},
"htmlCount": {
@@ -601,11 +773,14 @@ var policies = {
"isOkThreshold": 10,
"isBadThreshold": 20,
"isAbnormalThreshold": 30,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var fileObj = offendersHelpers.fileWithSizePattern(offender);
- return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
- });
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ return offendersHelpers.fileWithSizePattern(offender);
+ })
+ };
}
},
"jsCount": {
@@ -615,11 +790,14 @@ var policies = {
"isOkThreshold": 5,
"isBadThreshold": 15,
"isAbnormalThreshold": 30,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var fileObj = offendersHelpers.fileWithSizePattern(offender);
- return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
- });
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ return offendersHelpers.fileWithSizePattern(offender);
+ })
+ };
}
},
"cssCount": {
@@ -629,11 +807,14 @@ var policies = {
"isOkThreshold": 3,
"isBadThreshold": 10,
"isAbnormalThreshold": 22,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var fileObj = offendersHelpers.fileWithSizePattern(offender);
- return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
- });
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ return offendersHelpers.fileWithSizePattern(offender);
+ })
+ };
}
},
"imageCount": {
@@ -643,11 +824,14 @@ var policies = {
"isOkThreshold": 15,
"isBadThreshold": 40,
"isAbnormalThreshold": 70,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var fileObj = offendersHelpers.fileWithSizePattern(offender);
- return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
- });
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ return offendersHelpers.fileWithSizePattern(offender);
+ })
+ };
}
},
"webfontCount": {
@@ -657,11 +841,14 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 3,
"isAbnormalThreshold": 5,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var fileObj = offendersHelpers.fileWithSizePattern(offender);
- return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
- });
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ return offendersHelpers.fileWithSizePattern(offender);
+ })
+ };
}
},
"videoCount": {
@@ -671,11 +858,14 @@ var policies = {
"isOkThreshold": 1,
"isBadThreshold": 5,
"isAbnormalThreshold": 15,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var fileObj = offendersHelpers.fileWithSizePattern(offender);
- return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
- });
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ return offendersHelpers.fileWithSizePattern(offender);
+ })
+ };
}
},
"jsonCount": {
@@ -685,11 +875,14 @@ var policies = {
"isOkThreshold": 2,
"isBadThreshold": 10,
"isAbnormalThreshold": 25,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var fileObj = offendersHelpers.fileWithSizePattern(offender);
- return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
- });
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ return offendersHelpers.fileWithSizePattern(offender);
+ })
+ };
}
},
"otherCount": {
@@ -699,11 +892,14 @@ var policies = {
"isOkThreshold": 5,
"isBadThreshold": 20,
"isAbnormalThreshold": 40,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var fileObj = offendersHelpers.fileWithSizePattern(offender);
- return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
- });
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ return offendersHelpers.fileWithSizePattern(offender);
+ })
+ };
}
},
"smallJsFiles": {
@@ -713,11 +909,14 @@ var policies = {
"isOkThreshold": 2,
"isBadThreshold": 10,
"isAbnormalThreshold": 16,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var fileObj = offendersHelpers.fileWithSizePattern(offender);
- return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
- });
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ return offendersHelpers.fileWithSizePattern(offender);
+ })
+ };
}
},
"smallCssFiles": {
@@ -727,11 +926,14 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 8,
"isAbnormalThreshold": 12,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var fileObj = offendersHelpers.fileWithSizePattern(offender);
- return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
- });
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ return offendersHelpers.fileWithSizePattern(offender);
+ })
+ };
}
},
"smallImages": {
@@ -741,11 +943,14 @@ var policies = {
"isOkThreshold": 2,
"isBadThreshold": 17,
"isAbnormalThreshold": 30,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var fileObj = offendersHelpers.fileWithSizePattern(offender);
- return offendersHelpers.urlToLink(fileObj.file) + ((fileObj.size !== undefined) ? ' (' + fileObj.size + ' kB)' : '');
- });
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ return offendersHelpers.fileWithSizePattern(offender);
+ })
+ };
}
},
"notFound": {
@@ -755,11 +960,7 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 1,
"isAbnormalThreshold": 1,
- "offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- return offendersHelpers.urlToLink(offender);
- });
- }
+ "hasOffenders": true
},
"closedConnections": {
"tool": "phantomas",
@@ -768,11 +969,7 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 8,
"isAbnormalThreshold": 20,
- "offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- return offendersHelpers.urlToLink(offender);
- });
- }
+ "hasOffenders": true
},
"multipleRequests": {
"tool": "phantomas",
@@ -781,11 +978,7 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 3,
"isAbnormalThreshold": 10,
- "offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- return offendersHelpers.urlToLink(offender);
- });
- }
+ "hasOffenders": true
},
"cachingDisabled": {
"tool": "phantomas",
@@ -794,11 +987,7 @@ var policies = {
"isOkThreshold": 0,
"isBadThreshold": 12,
"isAbnormalThreshold": 25,
- "offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- return offendersHelpers.urlToLink(offender);
- });
- }
+ "hasOffenders": true
},
"cachingNotSpecified": {
"tool": "phantomas",
@@ -807,11 +996,7 @@ var policies = {
"isOkThreshold": 5,
"isBadThreshold": 20,
"isAbnormalThreshold": 40,
- "offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- return offendersHelpers.urlToLink(offender);
- });
- }
+ "hasOffenders": true
},
"cachingTooShort": {
"tool": "phantomas",
@@ -820,45 +1005,56 @@ var policies = {
"isOkThreshold": 5,
"isBadThreshold": 20,
"isAbnormalThreshold": 40,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders
- .map(function(offender) {
- var parts = /^([^ ]*) cached for (-?\d+(\.\d+)?) s$/.exec(offender);
+ return {
+ count: offenders.length,
+ list: offenders
+ .map(function(offender) {
+ var parts = /^([^ ]*) cached for (-?\d+(\.\d+)?) s$/.exec(offender);
+
+ if (!parts) {
+ debug('cachingTooShort offenders transform function error with "%s"', offender);
+ return {
+ file: offender
+ };
+ }
- if (!parts) {
- debug('cachingTooShort offenders transform function error with "%s"', offender);
return {
- file: offender
+ file: parts[1],
+ ttl: Math.round(parseFloat(parts[2]))
};
- }
- return {
- file: parts[1],
- ttl: Math.round(parseFloat(parts[2]))
- };
- }).sort(function(a, b) {
- return a.ttl - b.ttl;
- }).map(function(obj) {
- var duration = obj.ttl;
- var unit = 'seconds';
+ }).sort(function(a, b) {
- if (duration >= 120) {
- duration = Math.round(duration / 60);
- unit = 'minutes';
- }
+ return a.ttl - b.ttl;
- if (duration >= 120) {
- duration = Math.round(duration / 60);
- unit = 'hours';
- }
+ }).map(function(obj) {
- if (duration >= 48) {
- duration = Math.round(duration / 24);
- unit = 'days';
- }
+ var duration = obj.ttl;
+ var unit = 'seconds';
- return offendersHelpers.urlToLink(obj.file) + ' cached for ' + duration + ' ' + unit + '';
- });
+ if (duration >= 120) {
+ duration = Math.round(duration / 60);
+ unit = 'minutes';
+ }
+
+ if (duration >= 120) {
+ duration = Math.round(duration / 60);
+ unit = 'hours';
+ }
+
+ if (duration >= 48) {
+ duration = Math.round(duration / 24);
+ unit = 'days';
+ }
+
+ obj.ttlWithUnit = duration;
+ obj.unit = unit;
+
+ return obj;
+ })
+ };
}
},
"domains": {
@@ -868,17 +1064,27 @@ var policies = {
"isOkThreshold": 10,
"isBadThreshold": 25,
"isAbnormalThreshold": 50,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.map(function(offender) {
- var parts = /^([^ ]*): (\d+) request\(s\)$/.exec(offender);
+ return {
+ count: offenders.length,
+ list: offenders.map(function(offender) {
+ var parts = /^([^ ]*): (\d+) request\(s\)$/.exec(offender);
- if (!parts) {
- debug('domains offenders transform function error with "%s"', offender);
- return offender;
- }
+ if (!parts) {
+ debug('domains offenders transform function error with "%s"', offender);
+ return {
+ file: offender
+ };
+ }
- return '' + parts[1] + ' (' + parts[2] + ' ' + ((parseInt(parts[2], 10) > 1) ? 'requests' : 'request') + ')';
- });
+ return {
+ domain: parts[1],
+ requests: parseInt(parts[2])
+ };
+
+ })
+ };
}
}
};
diff --git a/lib/offendersHelpers.js b/lib/offendersHelpers.js
index 36151c6..f2dde54 100644
--- a/lib/offendersHelpers.js
+++ b/lib/offendersHelpers.js
@@ -31,70 +31,69 @@ var OffendersHelpers = function() {
return result;
};
- this.domTreeToHTML = function(domTree) {
-
- function recursiveHtmlBuilder(tree) {
- var html = '';
- var keys = Object.keys(tree);
-
- keys.forEach(function(key) {
- if (isNaN(tree[key])) {
- html += '' + key + '' + recursiveHtmlBuilder(tree[key]) + '
';
- } else if (tree[key] > 1) {
- html += '' + key + ' (x' + tree[key] + ')
';
- } else {
- html += '' + key + '
';
- }
- });
-
- return html;
- }
-
- return '' + recursiveHtmlBuilder(domTree) + '
';
- };
-
- this.listOfDomPathsToHTML = function(domPaths) {
- var domArrays = domPaths.map(this.domPathToArray);
- var domTree = this.listOfDomArraysToTree(domArrays);
- return this.domTreeToHTML(domTree);
- };
-
- this.domPathToButton = function(domPath) {
+ this.domPathToDomElementObj = function(domPath) {
var domArray = this.domPathToArray(domPath);
- var domTree = this.listOfDomPathsToHTML([domPath]);
+ var domTree = this.listOfDomArraysToTree([this.domPathToArray(domPath)]);
if (domArray[0] === 'html') {
- return 'html
';
+ return {
+ type: 'html'
+ };
}
if (domArray[0] === 'body') {
if (domArray.length === 1) {
- return 'body
';
+ return {
+ type: 'body'
+ };
} else {
- return 'DOM element ' + domArray[domArray.length - 1] + '' + domTree + '
';
+ return {
+ type: 'domElement',
+ element: domArray[domArray.length - 1],
+ tree: domTree
+ };
}
}
if (domArray[0] === 'head') {
- return 'head
';
+ return {
+ type: 'head'
+ };
}
if (domArray[0] === '#document') {
- return 'document
';
+ return {
+ type: 'document'
+ };
}
if (domArray[0] === 'window') {
- return 'window
';
+ return {
+ type: 'window'
+ };
}
if (domArray[0] === 'DocumentFragment') {
if (domArray.length === 1) {
- return 'Fragment
';
+ return {
+ type: 'fragment'
+ };
} else {
- return 'Fragment element ' + domArray[domArray.length - 1] + '' + domTree + '
';
+ return {
+ type: 'fragmentElement',
+ element: domArray[domArray.length - 1],
+ tree: domTree
+ };
}
}
// Not attached element, such as just created with document.createElement()
if (domArray.length === 1) {
- return 'Created element ' + domPath + '
';
+ return {
+ type: 'createdElement',
+ element: domPath
+ };
} else {
- return 'Created element ' + domArray[domArray.length - 1] + '' + domTree + '
';
+ return {
+ type: 'createdElement',
+ element: domArray[domArray.length - 1],
+ tree: domTree
+ };
}
};
@@ -130,20 +129,6 @@ var OffendersHelpers = function() {
}
};
- this.backtraceArrayToHtml = function(backtraceArray) {
- if (backtraceArray.length === 0) {
- return 'no backtrace
';
- }
-
- var html = '';
- };
-
this.sortVarsLikeChromeDevTools = function(vars) {
return vars.sort(function(a, b) {
@@ -157,7 +142,7 @@ var OffendersHelpers = function() {
};
this.cssOffenderPattern = function(offender) {
- var parts = /^(.*) @ (\d+):(\d+)$/.exec(offender);
+ var parts = /^(.*) (?:<([^ \(]*)>|\[inline CSS\]) @ (\d+):(\d+)$/.exec(offender);
if (!parts) {
return {
@@ -165,9 +150,10 @@ var OffendersHelpers = function() {
};
} else {
return {
- offender: parts[1],
- line: parseInt(parts[2], 10),
- character: parseInt(parts[3], 10)
+ css: parts[1],
+ file: parts[2] || null,
+ line: parseInt(parts[3], 10),
+ column: parseInt(parts[4], 10)
};
}
};
diff --git a/lib/rulesChecker.js b/lib/rulesChecker.js
index 8f82b68..b82b7d7 100644
--- a/lib/rulesChecker.js
+++ b/lib/rulesChecker.js
@@ -26,52 +26,64 @@ var RulesChecker = function() {
policy: extend({}, policy) // Clone object policy instead of reference
};
- var offenders = [];
- // Take DOMqueriesAvoidable's offenders from DOMqueriesDuplicated, for example.
- if (policy.takeOffendersFrom) {
-
- var fromList = policy.takeOffendersFrom;
-
- // takeOffendersFrom option can be a string or an array of strings.
- if (typeof fromList === 'string') {
- fromList = [fromList];
- }
-
- fromList.forEach(function(from) {
- if (data.toolsResults[policy.tool] &&
- data.toolsResults[policy.tool].offenders &&
- data.toolsResults[policy.tool].offenders[from]) {
- offenders = offenders.concat(data.toolsResults[policy.tool].offenders[from]);
+ // Deal with offenders
+ if (policy.hasOffenders) {
+
+ var offenders = [];
+
+ // Take DOMqueriesAvoidable's offenders from DOMqueriesDuplicated, for example.
+ if (policy.takeOffendersFrom) {
+
+ var fromList = policy.takeOffendersFrom;
+
+ // takeOffendersFrom option can be a string or an array of strings.
+ if (typeof fromList === 'string') {
+ fromList = [fromList];
}
- });
+
+ fromList.forEach(function(from) {
+ if (data.toolsResults[policy.tool] &&
+ data.toolsResults[policy.tool].offenders &&
+ data.toolsResults[policy.tool].offenders[from]) {
+ offenders = offenders.concat(data.toolsResults[policy.tool].offenders[from]);
+ }
+ });
- data.toolsResults[policy.tool].offenders[metricName] = offenders;
+ data.toolsResults[policy.tool].offenders[metricName] = offenders;
- } else if (data.toolsResults[policy.tool] &&
- data.toolsResults[policy.tool].offenders &&
- data.toolsResults[policy.tool].offenders[metricName]) {
- offenders = data.toolsResults[policy.tool].offenders[metricName];
- }
-
- // It is possible to declare a transformation function for the offenders.
- // The function should take an array of strings as single parameter and return a string.
- if (policy.offendersTransformFn) {
- rule.offendersCount = offenders.length;
-
- try {
- offenders = policy.offendersTransformFn(offenders);
- } catch(err) {
- debug('Error while transforming offenders for %s', metricName);
- debug(err);
+ } else if (data.toolsResults[policy.tool] &&
+ data.toolsResults[policy.tool].offenders &&
+ data.toolsResults[policy.tool].offenders[metricName]) {
+ offenders = data.toolsResults[policy.tool].offenders[metricName];
}
+
+ var offendersObj = {};
- delete rule.policy.offendersTransformFn;
+ // It is possible to declare a transformation function for the offenders.
+ // The function should take an array of strings as single parameter and return a string.
+ if (policy.offendersTransformFn) {
+
+ try {
+ offendersObj = policy.offendersTransformFn(offenders);
+ } catch(err) {
+ debug('Error while transforming offenders for %s', metricName);
+ debug(err);
+ }
+
+ delete rule.policy.offendersTransformFn;
+
+ } else {
+
+ offendersObj = {
+ count: offenders.length,
+ list: offenders
+ };
+ }
+
+ rule.offendersObj = offendersObj;
}
- if (offenders && offenders.length > 0) {
- rule.offenders = offenders;
- }
rule.bad = rule.value > policy.isOkThreshold;
rule.abnormal = policy.isAbnormalThreshold && rule.value >= policy.isAbnormalThreshold;
diff --git a/lib/tools/phantomas/phantomasWrapper.js b/lib/tools/phantomas/phantomasWrapper.js
index 4706201..594cde9 100644
--- a/lib/tools/phantomas/phantomasWrapper.js
+++ b/lib/tools/phantomas/phantomasWrapper.js
@@ -40,7 +40,8 @@ var PhantomasWrapper = function() {
'eventListeners', // overridden
'filmStrip', // not needed
'har', // not needed for the moment
- 'javaScriptBottlenecks', // needs to be launched after custom module scopeYLT,
+ 'javaScriptBottlenecks', // needs to be launched after custom module scopeYLT
+ 'jQuery', // overridden
'jserrors', // overridden
'pageSource', // not needed
'screenshot', // not needed for the moment
diff --git a/test/core/customPoliciesTest.js b/test/core/customPoliciesTest.js
index 5593f2f..302b1c4 100644
--- a/test/core/customPoliciesTest.js
+++ b/test/core/customPoliciesTest.js
@@ -4,10 +4,362 @@ var rulesChecker = require('../../lib/rulesChecker');
describe('rulesChecker', function() {
var policies = require('../../lib/metadata/policies.js');
+ var results;
+ it('should transform DOMelementMaxDepth offenders', function() {
+ results = rulesChecker.check({
+ "toolsResults": {
+ "phantomas": {
+ "metrics": {
+ "DOMelementMaxDepth": 3
+ },
+ "offenders": {
+ "DOMelementMaxDepth": [
+ "body > div#foo > span.bar"
+ ]
+ }
+ }
+ }
+ }, policies);
+
+ results.should.have.a.property('DOMelementMaxDepth');
+ results.DOMelementMaxDepth.should.have.a.property('offendersObj').that.deep.equals({
+ "count": 1,
+ "tree": {
+ "body": {
+ "div#foo": {
+ "span.bar": 1
+ }
+ }
+ }
+ });
+ });
+
+
+ it('should transform DOMidDuplicated offenders', function() {
+ results = rulesChecker.check({
+ "toolsResults": {
+ "phantomas": {
+ "metrics": {
+ "DOMidDuplicated": 2
+ },
+ "offenders": {
+ "DOMidDuplicated": [
+ "colorswitch-30883-30865: 4 occurrences",
+ "foo: 1 occurrences"
+ ]
+ }
+ }
+ }
+ }, policies);
+
+ results.should.have.a.property('DOMidDuplicated');
+ results.DOMidDuplicated.should.have.a.property('offendersObj').that.deep.equals({
+ "count": 2,
+ "list": [
+ {
+ "id": "colorswitch-30883-30865",
+ "occurrences": 4
+ },
+ {
+ "id": "foo",
+ "occurrences": 1
+ }
+ ]
+ });
+ });
+
+
+ it('should transform DOMinserts offenders', function() {
+ results = rulesChecker.check({
+ "toolsResults": {
+ "phantomas": {
+ "metrics": {
+ "DOMinserts": 4
+ },
+ "offenders": {
+ "DOMinserts": [
+ "\"div\" appended to \"html\"",
+ "\"DocumentFragment > link[0]\" appended to \"head\"",
+ "\"div#Netaff-yh1XbS0vK3NaRGu\" appended to \"body > div#Global\"",
+ "\"img\" appended to \"body\""
+ ]
+ }
+ }
+ }
+ }, policies);
+
+ results.should.have.a.property('DOMinserts');
+ results.DOMinserts.should.have.a.property('offendersObj').that.deep.equals({
+ "count": 4,
+ "list": [
+ {
+ "insertedElement": {
+ "type": "createdElement",
+ "element": "div"
+ },
+ "receiverElement": {
+ "type": "html"
+ }
+ },
+ {
+ "insertedElement": {
+ "type": "fragmentElement",
+ "element": "link[0]",
+ "tree": {
+ "DocumentFragment": {
+ "link[0]": 1
+ }
+ }
+ },
+ "receiverElement": {
+ "type": "head"
+ }
+ },
+ {
+ "insertedElement": {
+ "type": "createdElement",
+ "element": "div#Netaff-yh1XbS0vK3NaRGu"
+ },
+ "receiverElement": {
+ "type": "domElement",
+ "element": "div#Global",
+ "tree": {
+ "body": {
+ "div#Global": 1
+ }
+ }
+ }
+ },
+ {
+ "insertedElement": {
+ "type": "createdElement",
+ "element": "img"
+ },
+ "receiverElement": {
+ "type": "body"
+ }
+ }
+ ]
+ });
+ });
+
+
+ it('should transform DOMqueriesWithoutResults offenders', function() {
+ results = rulesChecker.check({
+ "toolsResults": {
+ "phantomas": {
+ "metrics": {
+ "DOMqueriesWithoutResults": 2
+ },
+ "offenders": {
+ "DOMqueriesWithoutResults": [
+ "#SearchMenu (in #document) using getElementById",
+ ".partnership-link (in body > div#Global > div#Header > ul#MainMenu) using getElementsByClassName"
+ ]
+ }
+ }
+ }
+ }, policies);
+
+ results.should.have.a.property('DOMqueriesWithoutResults');
+ results.DOMqueriesWithoutResults.should.have.a.property('offendersObj').that.deep.equals({
+ "count": 2,
+ "list": [
+ {
+ "context": {
+ "type": "document"
+ },
+ "fn": "getElementById",
+ "query": "#SearchMenu "
+ },
+ {
+ "context": {
+ "element": "ul#MainMenu",
+ "tree": {
+ "body": {
+ "div#Global": {
+ "div#Header": {
+ "ul#MainMenu": 1
+ }
+ }
+ }
+ },
+ "type": "domElement"
+ },
+ "fn": "getElementsByClassName",
+ "query": ".partnership-link "
+ }
+ ]
+ });
+ });
+
+
+ it('should transform DOMqueriesAvoidable offenders', function() {
+ results = rulesChecker.check({
+ "toolsResults": {
+ "phantomas": {
+ "metrics": {
+ "DOMqueriesAvoidable": 2
+ },
+ "offenders": {
+ "DOMqueriesDuplicated": [
+ "id \"#j2t-top-cart\" with getElementById (in context #document): 4 queries",
+ "class \".listingResult\" with getElementsByClassName (in context body > div#Global > div#Listing): 4 queries"
+ ]
+ }
+ }
+ }
+ }, policies);
+
+ results.should.have.a.property('DOMqueriesAvoidable');
+ results.DOMqueriesAvoidable.should.have.a.property('offendersObj').that.deep.equals({
+ "count": 2,
+ "list": [
+ {
+ "query": "#j2t-top-cart",
+ "context": {
+ "type": "document"
+ },
+ "fn": "getElementById ",
+ "count": 4
+ },
+ {
+ "query": ".listingResult",
+ "context": {
+ "type": "domElement",
+ "element": "div#Listing",
+ "tree": {
+ "body": {
+ "div#Global": {
+ "div#Listing": 1
+ }
+ }
+ }
+ },
+ "fn": "getElementsByClassName ",
+ "count": 4
+ }
+ ]
+ });
+ });
+
+
+ it('should transform eventsBound offenders', function() {
+ results = rulesChecker.check({
+ "toolsResults": {
+ "phantomas": {
+ "metrics": {
+ "eventsBound": 2
+ },
+ "offenders": {
+ "eventsBound": [
+ "\"DOMContentLoaded\" bound to \"#document\"",
+ "\"unload\" bound to \"window\"",
+ "\"submit\" bound to \"body > div#Global > div#Header > form#search_mini_form\""
+ ]
+ }
+ }
+ }
+ }, policies);
+
+ results.should.have.a.property('eventsBound');
+ results.eventsBound.should.have.a.property('offendersObj').that.deep.equals({
+ "count": 3,
+ "list": [
+ {
+ "element": {
+ "type": "document"
+ },
+ "eventName": "DOMContentLoaded"
+ },
+ {
+ "element": {
+ "type": "window"
+ },
+ "eventName": "unload"
+ },
+ {
+ "element": {
+ "element": "form#search_mini_form",
+ "tree": {
+ "body": {
+ "div#Global": {
+ "div#Header": {
+ "form#search_mini_form": 1
+ }
+ }
+ }
+ },
+ "type": "domElement"
+ },
+ "eventName": "submit"
+ }
+ ]
+ });
+ });
+
+
+ it('should transform jsErrors offenders', function() {
+ results = rulesChecker.check({
+ "toolsResults": {
+ "phantomas": {
+ "metrics": {
+ "jsErrors": 2
+ },
+ "offenders": {
+ "jsErrors": [
+ "TypeError: 'undefined' is not a function (evaluating 'this.successfullyCollected.bind(this)') - http://asset.easydmp.net/js/collect.js:1160 / callCollecte http://asset.easydmp.net/js/collect.js:1203 / callbackUpdateParams http://asset.easydmp.net/js/collect.js:1135 / http://asset.easydmp.net/js/collect.js:1191",
+ "TypeError: 'undefined' is not an object (evaluating 'd.readyState') - http://me.hunkal.com/p/:3"
+ ]
+ }
+ }
+ }
+ }, policies);
+
+ results.should.have.a.property('jsErrors');
+ results.jsErrors.should.have.a.property('offendersObj').that.deep.equals({
+ "count": 2,
+ "list": [
+ {
+ "error": "TypeError: 'undefined' is not a function (evaluating 'this.successfullyCollected.bind(this)')",
+ "backtrace": [
+ {
+ "file": "http://asset.easydmp.net/js/collect.js",
+ "line": 1160
+ },
+ {
+ "file": "http://asset.easydmp.net/js/collect.js",
+ "line": 1203,
+ "functionName": "callCollecte"
+ },
+ {
+ "file": "http://asset.easydmp.net/js/collect.js",
+ "line": 1135,
+ "functionName": "callbackUpdateParams"
+ },
+ {
+ "file": "http://asset.easydmp.net/js/collect.js",
+ "line": 1191
+ }
+ ]
+ },
+ {
+ "error": "TypeError: 'undefined' is not an object (evaluating 'd.readyState')",
+ "backtrace": [
+ {
+ "file": "http://me.hunkal.com/p/",
+ "line": 3
+ }
+ ]
+ }
+ ]
+ });
+ });
+
+
it('should grade correctly jQuery versions', function() {
-
var versions = {
'1.2.9': 0,
@@ -84,4 +436,46 @@ describe('rulesChecker', function() {
results.jQueryDifferentVersions.should.have.a.property('score').that.equals(0);
results.jQueryDifferentVersions.should.have.a.property('abnormal').that.equals(true);
});
+
+
+ it('should transform cssParsingErrors offenders', function() {
+ results = rulesChecker.check({
+ "toolsResults": {
+ "phantomas": {
+ "metrics": {
+ "cssParsingErrors": 2
+ },
+ "offenders": {
+ "cssParsingErrors": [
+ " (Error: CSS parsing failed: missing '}' @ 4:1)",
+ " (Empty CSS was provided)"
+ ]
+ }
+ }
+ }
+ }, policies);
+
+ results.should.have.a.property('cssParsingErrors');
+ results.cssParsingErrors.should.have.a.property('offendersObj').that.deep.equals({
+ "count": 2,
+ "list": [
+ {
+ "error": "Error: CSS parsing failed: missing '}'",
+ "file": "http://www.sudexpress.com/skin/frontend/sudexpress/default/css/styles.css",
+ "line": 4,
+ "column": 1
+ },
+ {
+ "error": "Empty CSS was provided",
+ "file": "http://www.sudexpress.com/skin/frontend/sudexpress/default/css/reset.css",
+ "line": null,
+ "column": null
+ }
+ ]
+ });
+ });
+
+
+ // Enough for the moment, to be complete...
+
});
diff --git a/test/core/indexTest.js b/test/core/indexTest.js
index 715f2f9..2801b85 100644
--- a/test/core/indexTest.js
+++ b/test/core/indexTest.js
@@ -65,15 +65,22 @@ describe('index.js', function() {
"message": "A deep DOM makes the CSS matching with DOM elements difficult.
It also slows down JavaScript modifications to the DOM because changing the dimensions of an element makes the browser re-calculate the dimensions of it's parents. Same thing for JavaScript events, that bubble up to the document root.
",
"isOkThreshold": 10,
"isBadThreshold": 20,
- "isAbnormalThreshold": 28
+ "isAbnormalThreshold": 28,
+ "hasOffenders": true
},
"value": 1,
"bad": false,
"abnormal": false,
"score": 100,
"abnormalityScore": 0,
- "offenders": "",
- "offendersCount": 1
+ "offendersObj": {
+ "count": 1,
+ "tree": {
+ "body": {
+ "h1[1]": 1
+ }
+ }
+ }
});
// Test javascriptExecutionTree
diff --git a/test/core/offendersHelpersTest.js b/test/core/offendersHelpersTest.js
index d6632f0..6bf59c9 100644
--- a/test/core/offendersHelpersTest.js
+++ b/test/core/offendersHelpersTest.js
@@ -20,11 +20,15 @@ describe('offendersHelpers', function() {
describe('listOfDomArraysToTree', function() {
it('should transform a list of arrays into a tree', function() {
- var result = offendersHelpers.listOfDomArraysToTree([
+ var input = [
['body', 'section#page', 'div.alternate-color', 'ul.retroGuide', 'li[0]', 'div.retro-chaine.france2'],
['body', 'section#page', 'div.alternate-color', 'ul.retroGuide', 'li[0]', 'div.retro-chaine.france2'],
['body', 'section#page', 'div.alternate-color', 'ul.retroGuide', 'li[1]', 'div.retro-chaine.france2']
- ]);
+ ];
+
+ var inputClone = input.slice();
+
+ var result = offendersHelpers.listOfDomArraysToTree(input);
result.should.deep.equal({
'body': {
'section#page': {
@@ -41,95 +45,105 @@ describe('offendersHelpers', function() {
}
}
});
+
+ input.should.deep.equal(inputClone);
});
});
- describe('domTreeToHTML', function() {
+ describe('domPathToDomElementObj', function() {
- it('should transform a dom tree into HTML with the awaited format', function() {
- var result = offendersHelpers.domTreeToHTML({
- 'body': {
- 'ul.retroGuide': {
- 'li[0]': {
- 'div.retro-chaine.france2': 2
- },
- 'li[1]': {
- 'div.retro-chaine.france2': 1
+ it('should transform html', function() {
+ var result = offendersHelpers.domPathToDomElementObj('html');
+ result.should.deep.equal({
+ type: 'html'
+ });
+ });
+
+ it('should transform body', function() {
+ var result = offendersHelpers.domPathToDomElementObj('body');
+ result.should.deep.equal({
+ type: 'body'
+ });
+ });
+
+ it('should transform head', function() {
+ var result = offendersHelpers.domPathToDomElementObj('head');
+ result.should.deep.equal({
+ type: 'head'
+ });
+ });
+
+ it('should transform #document', function() {
+ var result = offendersHelpers.domPathToDomElementObj('#document');
+ result.should.deep.equal({
+ type: 'document'
+ });
+ });
+
+ it('should transform window', function() {
+ var result = offendersHelpers.domPathToDomElementObj('window');
+ result.should.deep.equal({
+ type: 'window'
+ });
+ });
+
+ it('should transform a standard in-body element', function() {
+ var result = offendersHelpers.domPathToDomElementObj('body > div#colorbox > div#cboxContent');
+ result.should.deep.equal({
+ type: 'domElement',
+ element: 'div#cboxContent',
+ tree: {
+ 'body': {
+ 'div#colorbox': {
+ 'div#cboxContent': 1
}
}
}
});
-
- result.should.equal('bodyul.retroGuideli[0]div.retro-chaine.france2 (x2)
li[1]div.retro-chaine.france2
');
- });
-
- });
-
- describe('listOfDomPathsToHTML', function() {
-
- it('should transform a list of path strings into HTML', function() {
- var result = offendersHelpers.listOfDomPathsToHTML([
- 'body > ul.retroGuide > li[0] > div.retro-chaine.france2',
- 'body > ul.retroGuide > li[1] > div.retro-chaine.france2',
- 'body > ul.retroGuide > li[0] > div.retro-chaine.france2',
- ]);
-
- result.should.equal('bodyul.retroGuideli[0]div.retro-chaine.france2 (x2)
li[1]div.retro-chaine.france2
');
- });
-
- });
-
- describe('domPathToButton', function() {
-
- it('should transform html', function() {
- var result = offendersHelpers.domPathToButton('html');
- result.should.equal('html
');
- });
-
- it('should transform body', function() {
- var result = offendersHelpers.domPathToButton('body');
- result.should.equal('body
');
- });
-
- it('should transform head', function() {
- var result = offendersHelpers.domPathToButton('head');
- result.should.equal('head
');
- });
-
- it('should transform #document', function() {
- var result = offendersHelpers.domPathToButton('#document');
- result.should.equal('document
');
- });
-
- it('should transform window', function() {
- var result = offendersHelpers.domPathToButton('window');
- result.should.equal('window
');
- });
-
- it('should transform a standard in-body element', function() {
- var result = offendersHelpers.domPathToButton('body > div#colorbox > div#cboxContent');
- result.should.equal('');
});
it('should transform a domFragment element', function() {
- var result = offendersHelpers.domPathToButton('DocumentFragment');
- result.should.equal('Fragment
');
+ var result = offendersHelpers.domPathToDomElementObj('DocumentFragment');
+ result.should.deep.equal({
+ type: 'fragment'
+ });
});
it('should transform a domFragment element', function() {
- var result = offendersHelpers.domPathToButton('DocumentFragment > div#colorbox > div#cboxContent');
- result.should.equal('');
+ var result = offendersHelpers.domPathToDomElementObj('DocumentFragment > div#colorbox > div#cboxContent');
+ result.should.deep.equal({
+ type: 'fragmentElement',
+ element: 'div#cboxContent',
+ tree: {
+ 'DocumentFragment': {
+ 'div#colorbox': {
+ 'div#cboxContent': 1
+ }
+ }
+ }
+ });
});
it('should transform an not-attached element', function() {
- var result = offendersHelpers.domPathToButton('div#sizcache');
- result.should.equal('Created element div#sizcache
');
+ var result = offendersHelpers.domPathToDomElementObj('div#sizcache');
+ result.should.deep.equal({
+ type: 'createdElement',
+ element: 'div#sizcache'
+ });
});
it('should transform an not-attached element path', function() {
- var result = offendersHelpers.domPathToButton('div > div#sizcache');
- result.should.equal('');
+ var result = offendersHelpers.domPathToDomElementObj('div > div#sizcache');
+ result.should.deep.equal({
+ type: 'createdElement',
+ element: 'div#sizcache',
+ tree: {
+ 'div': {
+ 'div#sizcache': 1
+ }
+ }
+ });
});
});
@@ -160,32 +174,6 @@ describe('offendersHelpers', function() {
});
- describe('backtraceArrayToHtml', function() {
-
- it('should create a button from a backtrace array', function() {
- var result = offendersHelpers.backtraceArrayToHtml([
- {
- file: 'http://pouet.com/js/jquery.footer-transverse-min-v1.0.20.js',
- line: 1
- },
- {
- functionName: 'callback',
- file: 'http://pouet.com/js/main.js',
- line: 1
- }
- ]);
-
- result.should.equal('');
- });
-
- it('should display "no backtrace"', function() {
- var result = offendersHelpers.backtraceArrayToHtml([]);
-
- result.should.equal('no backtrace
');
- });
-
- });
-
describe('sortVarsLikeChromeDevTools', function() {
it('should sort in the same strange order', function() {
@@ -248,12 +236,24 @@ describe('offendersHelpers', function() {
describe('cssOffenderPattern', function() {
it('should transform a css offender into an object', function() {
- var result = offendersHelpers.cssOffenderPattern('.pagination .plus ul li @ 30:31862');
+ var result = offendersHelpers.cssOffenderPattern('.pagination .plus ul li @ 30:31862');
result.should.deep.equal({
- offender: '.pagination .plus ul li',
+ css: '.pagination .plus ul li',
+ file: 'http://www.pouet.com/css/main.css',
line: 30,
- character: 31862
+ column: 31862
+ });
+ });
+
+ it('should work with an inline css', function() {
+ var result = offendersHelpers.cssOffenderPattern('.pagination .plus ul li [inline CSS] @ 1:32');
+
+ result.should.deep.equal({
+ css: '.pagination .plus ul li',
+ file: null,
+ line: 1,
+ column: 32
});
});
diff --git a/test/fixtures/rulesCheckerOutput.json b/test/fixtures/rulesCheckerOutput.json
index 9f6ddf4..e12ad22 100644
--- a/test/fixtures/rulesCheckerOutput.json
+++ b/test/fixtures/rulesCheckerOutput.json
@@ -6,7 +6,8 @@
"message": "A great message",
"isOkThreshold": 1000,
"isBadThreshold": 3000,
- "isAbnormalThreshold": 5000
+ "isAbnormalThreshold": 5000,
+ "hasOffenders": false
},
"value": 1236,
"bad": true,
@@ -22,11 +23,14 @@
"isOkThreshold": 1000,
"isBadThreshold": 3000,
"isAbnormalThreshold": 5000,
+ "hasOffenders": true,
"takeOffendersFrom": "metric3"
},
"value": 222,
- "offenders": "offender1 - offender2",
- "offendersCount": 2,
+ "offendersObj": {
+ "count": 2,
+ "str": "offender1 - offender2"
+ },
"bad": false,
"abnormal": false,
"score": 100,
@@ -39,11 +43,14 @@
"message": "A great message",
"isOkThreshold": 1000,
"isBadThreshold": 3000,
- "isAbnormalThreshold": 5000
+ "isAbnormalThreshold": 5000,
+ "hasOffenders": true
},
"value": 6666,
- "offenders": "offender1/offender2",
- "offendersCount": 2,
+ "offendersObj": {
+ "count": 2,
+ "test": "offender1/offender2"
+ },
"bad": true,
"abnormal": true,
"score": 0,
@@ -56,10 +63,14 @@
"message": "A great message",
"isOkThreshold": 1000,
"isBadThreshold": 3000,
- "isAbnormalThreshold": 5000
+ "isAbnormalThreshold": 5000,
+ "hasOffenders": true
},
"value": 1000,
- "offenders": ["offender3"],
+ "offendersObj": {
+ "count": 1,
+ "list": ["offender3"]
+ },
"bad": false,
"abnormal": false,
"score": 100,
@@ -73,10 +84,14 @@
"isOkThreshold": 1000,
"isBadThreshold": 3000,
"isAbnormalThreshold": 5000,
+ "hasOffenders": true,
"takeOffendersFrom": ["metric3", "metric4"]
},
"value": 3000,
- "offenders": ["offender1", "offender2", "offender3"],
+ "offendersObj": {
+ "count": 3,
+ "list": ["offender1", "offender2", "offender3"]
+ },
"bad": true,
"abnormal": false,
"score": 0,
@@ -120,7 +135,8 @@
"message": "This is from another tool!
",
"isOkThreshold": 0,
"isBadThreshold": 3,
- "isAbnormalThreshold": 11
+ "isAbnormalThreshold": 11,
+ "hasOffenders": false
},
"value": 22,
"bad": true,
diff --git a/test/fixtures/rulesCheckerPolicies.js b/test/fixtures/rulesCheckerPolicies.js
index a4fecab..2391781 100644
--- a/test/fixtures/rulesCheckerPolicies.js
+++ b/test/fixtures/rulesCheckerPolicies.js
@@ -6,7 +6,8 @@ var policies = {
"message": "A great message",
"isOkThreshold": 1000,
"isBadThreshold": 3000,
- "isAbnormalThreshold": 5000
+ "isAbnormalThreshold": 5000,
+ "hasOffenders": false
},
"metric2": {
"tool": "tool1",
@@ -16,8 +17,12 @@ var policies = {
"isBadThreshold": 3000,
"isAbnormalThreshold": 5000,
"takeOffendersFrom": "metric3",
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.join(' - ');
+ return {
+ count: 2,
+ str: offenders.join(' - ')
+ };
}
},
"metric3": {
@@ -27,8 +32,12 @@ var policies = {
"isOkThreshold": 1000,
"isBadThreshold": 3000,
"isAbnormalThreshold": 5000,
+ "hasOffenders": true,
"offendersTransformFn": function(offenders) {
- return offenders.join('/');
+ return {
+ count: 2,
+ test: offenders.join('/')
+ };
}
},
"metric4": {
@@ -37,7 +46,8 @@ var policies = {
"message": "A great message",
"isOkThreshold": 1000,
"isBadThreshold": 3000,
- "isAbnormalThreshold": 5000
+ "isAbnormalThreshold": 5000,
+ "hasOffenders": true,
},
"metric5": {
"tool": "tool1",
@@ -46,6 +56,7 @@ var policies = {
"isOkThreshold": 1000,
"isBadThreshold": 3000,
"isAbnormalThreshold": 5000,
+ "hasOffenders": true,
"takeOffendersFrom": ["metric3", "metric4"]
},
"metric6": {
@@ -71,7 +82,8 @@ var policies = {
"message": "This is from another tool!
",
"isOkThreshold": 0,
"isBadThreshold": 3,
- "isAbnormalThreshold": 11
+ "isAbnormalThreshold": 11,
+ "hasOffenders": false,
},
"unexistantMetric": {
@@ -80,13 +92,15 @@ var policies = {
"message": "",
"isOkThreshold": 1000,
"isBadThreshold": 3000,
- "isAbnormalThreshold": 5000
+ "isAbnormalThreshold": 5000,
+ "hasOffenders": true
},
"unexistantTool": {
"tool": "unexistant",
"isOkThreshold": 1000,
"isBadThreshold": 3000,
- "isAbnormalThreshold": 5000
+ "isAbnormalThreshold": 5000,
+ "hasOffenders": false
}
};
From 61c09a5b49da9627b973596f88ef830aca4d39d2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Mon, 26 Jan 2015 15:10:26 +0100
Subject: [PATCH 18/54] Revert custom dev and implement jQueryVersionsLoaded
---
front/src/views/rule.html | 2 +-
lib/metadata/policies.js | 4 +-
lib/metadata/scoreProfileGeneric.json | 2 +-
.../custom_modules/modules/jQYLT/jQYLT.js | 108 ++++++++++--------
4 files changed, 65 insertions(+), 51 deletions(-)
diff --git a/front/src/views/rule.html b/front/src/views/rule.html
index 28e3c31..ab7d250 100644
--- a/front/src/views/rule.html
+++ b/front/src/views/rule.html
@@ -128,7 +128,7 @@
()
-
+
{{offender}}
diff --git a/lib/metadata/policies.js b/lib/metadata/policies.js
index 00e667b..ac11d83 100644
--- a/lib/metadata/policies.js
+++ b/lib/metadata/policies.js
@@ -273,7 +273,7 @@ var policies = {
"message": "
Current latest versions of jQuery are 1.11 (with support for old IE versions) and 2.1 (without).
Each new version of jQuery optimizes performances. Do not keep an old version of jQuery. Updating can sometimes break a few things, but it is generally quite easy to fix them up. So don't hesitate.
",
"hasOffenders": false,
"scoreFn": function(data) {
- var differentVersions = data.toolsResults.phantomas.metrics.jQueryDifferentVersions;
+ var differentVersions = data.toolsResults.phantomas.metrics.jQueryVersionsLoaded;
if (differentVersions === 0 || differentVersions > 1 || !data.toolsResults.phantomas.metrics.jQueryVersion) {
// Not applicable
@@ -322,7 +322,7 @@ var policies = {
}
}
},
- "jQueryDifferentVersions": {
+ "jQueryVersionsLoaded": {
"tool": "phantomas",
"label": "Several versions loaded",
"message": "
jQuery is a heavy library. You should never load jQuery more than once on the same page.
",
diff --git a/lib/metadata/scoreProfileGeneric.json b/lib/metadata/scoreProfileGeneric.json
index 48a81bb..8a3b2d3 100644
--- a/lib/metadata/scoreProfileGeneric.json
+++ b/lib/metadata/scoreProfileGeneric.json
@@ -32,7 +32,7 @@
"label": "jQuery version",
"policies": {
"jQueryVersion": 5,
- "jQueryDifferentVersions": 0.1
+ "jQueryVersionsLoaded": 0.1
}
},
"cssSyntaxError": {
diff --git a/lib/tools/phantomas/custom_modules/modules/jQYLT/jQYLT.js b/lib/tools/phantomas/custom_modules/modules/jQYLT/jQYLT.js
index d76db71..c4a962d 100644
--- a/lib/tools/phantomas/custom_modules/modules/jQYLT/jQYLT.js
+++ b/lib/tools/phantomas/custom_modules/modules/jQYLT/jQYLT.js
@@ -7,16 +7,17 @@
/* global document: true, window: true */
/* jshint -W030 */
-exports.version = '0.2.a';
+exports.version = '1.0.a';
exports.module = function(phantomas) {
'use strict';
phantomas.setMetric('jQueryVersion', ''); // @desc version of jQuery framework (if loaded) [string]
+ phantomas.setMetric('jQueryVersionsLoaded'); // @desc number of loaded jQuery "instances" (even in the same version)
phantomas.setMetric('jQueryOnDOMReadyFunctions'); // @desc number of functions bound to onDOMReady event
+ phantomas.setMetric('jQueryWindowOnLoadFunctions'); // @desc number of functions bound to windowOnLoad event
phantomas.setMetric('jQuerySizzleCalls'); // @desc number of calls to Sizzle (including those that will be resolved using querySelectorAll)
- phantomas.setMetric('jQuerySizzleCallsDuplicated'); // @desc number of calls on the same Sizzle request
- phantomas.setMetric('jQueryDifferentVersions'); //@desc number of different jQuery versions loaded on the page (not counting iframes)
+ //phantomas.setMetric('jQueryEventTriggers'); // @desc number of jQuery event triggers
var jQueryFunctions = [
// DOM manipulations
@@ -110,30 +111,28 @@ exports.module = function(phantomas) {
phantomas.evaluate(function(jQueryFunctions) {
(function(phantomas) {
var jQuery;
+ var oldJQuery;
- // TODO: create a helper - phantomas.spyGlobalVar() ?
- window.__defineSetter__('jQuery', function(val) {
+ phantomas.spyGlobalVar('jQuery', function(jQuery) {
var version;
- var jQueryFn;
- var oldJQuery = jQuery;
- if (!val || !val.fn) {
+ if (!jQuery || !jQuery.fn) {
phantomas.log('jQuery: unable to detect version!');
return;
}
- version = val.fn.jquery;
- jQuery = val;
- jQueryFn = val.fn;
- // Older jQuery (v?.?) compatibility
- if (!jQueryFn) {
- jQueryFn = jQuery;
+ // Tag the current version of jQuery to avoid multiple reports of jQuery being loaded
+ // when it's actually only restored via $.noConflict(true) - see comments in #435
+ if (jQuery.__phantomas === true) {
+ phantomas.log('jQuery: this instance has already been seen by phantomas');
+ return;
}
+ jQuery.__phantomas = true;
- phantomas.log('jQuery: loaded v' + version);
- phantomas.setMetric('jQueryVersion', version);
+ // report the version of jQuery
+ version = jQuery.fn.jquery;
phantomas.emit('jQueryLoaded', version);
-
+
phantomas.pushContext({
type: (oldJQuery) ? 'jQuery version change' : 'jQuery loaded',
callDetails: {
@@ -141,11 +140,13 @@ exports.module = function(phantomas) {
},
backtrace: phantomas.getBacktrace()
});
+ oldJQuery = version;
// jQuery.ready.promise
// works for jQuery 1.8.0+ (released Aug 09 2012)
- phantomas.spy(val.ready, 'promise', function(func) {
+ phantomas.spy(jQuery.ready, 'promise', function(func) {
phantomas.incrMetric('jQueryOnDOMReadyFunctions');
+ phantomas.addOffender('jQueryOnDOMReadyFunctions', phantomas.getCaller(3));
phantomas.pushContext({
type: 'jQuery - onDOMReady',
@@ -160,9 +161,9 @@ exports.module = function(phantomas) {
// Sizzle calls - jQuery.find
// works for jQuery 1.3+ (released Jan 13 2009)
- phantomas.spy(val, 'find', function(selector, context) {
+ phantomas.spy(jQuery, 'find', function(selector, context) {
phantomas.incrMetric('jQuerySizzleCalls');
- phantomas.emit('onSizzleCall', selector + ' (context: ' + (phantomas.getDOMPath(context) || 'unknown') + ')');
+ phantomas.addOffender('jQuerySizzleCalls', '%s (in %s)', selector, (phantomas.getDOMPath(context) || 'unknown'));
phantomas.enterContext({
type: 'jQuery - find',
@@ -183,12 +184,39 @@ exports.module = function(phantomas) {
phantomas.leaveContext(moreData);
}) || phantomas.log('jQuery: can not measure jQuerySizzleCalls (jQuery used on the page is too old)!');
+ /*if (!jQuery.event) {
+ phantomas.spy(jQuery.event, 'trigger', function(ev, data, elem) {
+ var path = phantomas.getDOMPath(elem),
+ type = ev.type || ev;
+
+ phantomas.log('Event: triggered "%s" on "%s"', type, path);
+
+ phantomas.incrMetric('jQueryEventTriggers');
+ phantomas.addOffender('jQueryEventTriggers', '"%s" on "%s"', type, path);
+ });
+ }*/
+
+ // jQuery events bound to window' onLoad event (#451)
+ phantomas.spy(jQuery.fn, 'on', function(eventName, func) {
+ if ((eventName === 'load') && (this[0] === window)) {
+ phantomas.incrMetric('jQueryWindowOnLoadFunctions');
+ phantomas.addOffender('jQueryWindowOnLoadFunctions', phantomas.getCaller(2));
+
+ phantomas.pushContext({
+ type: 'jQuery - windowOnLoad',
+ callDetails: {
+ arguments: [func]
+ },
+ backtrace: phantomas.getBacktrace()
+ });
+ }
+ });
// Add spys on many jQuery functions
jQueryFunctions.forEach(function(functionName) {
var capitalizedName = functionName.substring(0,1).toUpperCase() + functionName.substring(1);
- phantomas.spy(jQueryFn, functionName, function(args) {
+ phantomas.spy(jQuery.fn, functionName, function(args) {
// Clean args
args = [].slice.call(arguments);
@@ -263,42 +291,28 @@ exports.module = function(phantomas) {
phantomas.leaveContext();
}) || phantomas.log('jQuery: can not track jQuery - ' + capitalizedName + ' (this version of jQuery doesn\'t support it)');
});
-
-
- });
-
- window.__defineGetter__('jQuery', function() {
- return jQuery;
});
})(window.__phantomas);
}, jQueryFunctions);
});
- // count Sizzle calls to detect duplicated queries
- var Collection = require('../../util/collection'),
- sizzleCalls = new Collection(),
- jQueryLoading = new Collection();
-
- phantomas.on('onSizzleCall', function(request) {
- sizzleCalls.push(request);
+ // store the last resource that was received
+ // try to report where given jQuery version was loaded from
+ phantomas.on('recv', function(entry) {
+ if (entry.isJS) {
+ lastUrl = entry.url;
+ }
});
phantomas.on('jQueryLoaded', function(version) {
- jQueryLoading.push(version);
- });
+ phantomas.log('jQuery: loaded v' + version);
+ phantomas.setMetric('jQueryVersion', version);
- phantomas.on('report', function() {
- sizzleCalls.sort().forEach(function(id, cnt) {
- if (cnt > 1) {
- phantomas.incrMetric('jQuerySizzleCallsDuplicated');
- phantomas.addOffender('jQuerySizzleCallsDuplicated', '%s: %d', id, cnt);
- }
- });
+ // report multiple jQuery "instances" (issue #435)
+ phantomas.incrMetric('jQueryVersionsLoaded');
+ phantomas.addOffender('jQueryVersionsLoaded', 'v%s', version);
- jQueryLoading.forEach(function(version) {
- phantomas.incrMetric('jQueryDifferentVersions');
- phantomas.addOffender('jQueryDifferentVersions', '%s', version);
- });
+ phantomas.log('jQuery: v%s (probably loaded from <%s>)', version, lastUrl);
});
};
From ed4ddc0a432893d0ffd8a3e070f766712045791e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Mon, 26 Jan 2015 19:29:08 +0100
Subject: [PATCH 19/54] Add CSS colors count and a palette as offender
---
front/src/css/rule.css | 42 +++++++++++++++++++++++
front/src/less/rule.less | 48 +++++++++++++++++++++++++++
front/src/views/rule.html | 7 ++++
lib/metadata/policies.js | 46 +++++++++++++++++++++++++
lib/metadata/scoreProfileGeneric.json | 3 +-
lib/rulesChecker.js | 2 +-
test/core/customPoliciesTest.js | 16 ++++-----
7 files changed, 154 insertions(+), 10 deletions(-)
diff --git a/front/src/css/rule.css b/front/src/css/rule.css
index b66c470..2a2dce0 100644
--- a/front/src/css/rule.css
+++ b/front/src/css/rule.css
@@ -148,3 +148,45 @@
font-style: italic;
font-weight: normal;
}
+.colorPalette {
+ width: 30em;
+ border: 2px solid #000;
+ text-align: left;
+ /* Checkerboard background */
+ background-color: #ddd;
+ background-image: linear-gradient(45deg, #aaaaaa 25%, transparent 25%, transparent 75%, #aaaaaa 75%, #aaaaaa), linear-gradient(45deg, #aaaaaa 25%, transparent 25%, transparent 75%, #aaaaaa 75%, #aaaaaa);
+ background-size: 1em 1em;
+ background-position: 0 0, 0.5em 0.5em;
+}
+.colorPalette > div {
+ display: inline-block;
+ height: 2em;
+ position: relative;
+}
+.colorPalette > div div {
+ display: none;
+ position: absolute;
+ left: 100%;
+ top: 100%;
+ background: #FFF;
+ padding: 0.5em;
+ border: 2px solid #f1c40f;
+ border-radius: 0.5em;
+ white-space: nowrap;
+ z-index: 3;
+ font-weight: bold;
+}
+.colorPalette > div:hover div {
+ display: block;
+}
+.colorPalette > div:hover:after {
+ content: " ";
+ position: absolute;
+ background-color: inherit;
+ left: -0.2em;
+ top: -0.2em;
+ width: 100%;
+ height: 100%;
+ z-index: 2;
+ border: 0.2em solid #f1c40f;
+}
diff --git a/front/src/less/rule.less b/front/src/less/rule.less
index ccf862a..ce68297 100644
--- a/front/src/less/rule.less
+++ b/front/src/less/rule.less
@@ -168,4 +168,52 @@
font-weight: normal;
}
}
+}
+
+.colorPalette {
+ width: 30em;
+ border: 2px solid #000;
+ text-align: left;
+
+ /* Checkerboard background */
+ background-color: #ddd;
+ background-image: linear-gradient(45deg, #AAA 25%, transparent 25%, transparent 75%, #AAA 75%, #AAA), linear-gradient(45deg, #AAA 25%, transparent 25%, transparent 75%, #AAA 75%, #AAA);
+ background-size:1em 1em;
+ background-position:0 0, 0.5em 0.5em;
+
+ > div {
+ display: inline-block;
+ height: 2em;
+ position: relative;
+
+ div {
+ display: none;
+ position: absolute;
+ left: 100%;
+ top: 100%;
+ background: #FFF;
+ padding: 0.5em;
+ border: 2px solid #f1c40f;
+ border-radius: 0.5em;
+ white-space: nowrap;
+ z-index: 3;
+ font-weight: bold;
+ }
+
+ &:hover div {
+ display: block;
+ }
+
+ &:hover:after {
+ content: " ";
+ position: absolute;
+ background-color: inherit;
+ left: -0.2em;
+ top: -0.2em;
+ width: 100%;
+ height: 100%;
+ z-index: 2;
+ border: 0.2em solid #f1c40f;
+ }
+ }
}
\ No newline at end of file
diff --git a/front/src/views/rule.html b/front/src/views/rule.html
index ab7d250..e954f73 100644
--- a/front/src/views/rule.html
+++ b/front/src/views/rule.html
@@ -143,6 +143,13 @@
+
+
This is the color palette, sized by total occurrences:
+
+
{{offender.color}} ({{offender.occurrences}} times)
+
+
+
diff --git a/lib/metadata/policies.js b/lib/metadata/policies.js
index ac11d83..92b99e0 100644
--- a/lib/metadata/policies.js
+++ b/lib/metadata/policies.js
@@ -410,6 +410,52 @@ var policies = {
};
}
},
+ "cssColors": {
+ "tool": "phantomas",
+ "label": "Different colors",
+ "message": "
This is the number of different colors defined in CSS.
Your CSS project will be easier to maintain if you keep a small color set.
",
+ "isOkThreshold": 30,
+ "isBadThreshold": 150,
+ "isAbnormalThreshold": 300,
+ "hasOffenders": true,
+ "offendersTransformFn": function(offenders, ruleObject) {
+ var deduplicatedObj = {};
+
+ offenders.map(function(offender) {
+ var parts = /^([^ ]*) \((\d+) times\)$/.exec(offender);
+
+ if (!parts) {
+ debug('cssColors offenders transform function error with "%s"', offender);
+ return;
+ }
+
+ var color = parts[1];
+ var count = parseInt(parts[2], 10);
+
+ deduplicatedObj[color] = (deduplicatedObj[color] || 0) + count;
+ });
+
+ var deduplicatedTable = [];
+ for (var color in deduplicatedObj) {
+ deduplicatedTable.push({
+ color: color,
+ occurrences: deduplicatedObj[color]
+ });
+ }
+
+ deduplicatedTable.sort(function(a, b) {
+ return b.occurrences - a.occurrences;
+ });
+
+ // Override rules.value
+ ruleObject.value = deduplicatedTable.length;
+
+ return {
+ count: deduplicatedTable.length,
+ palette: deduplicatedTable
+ };
+ }
+ },
"cssImports": {
"tool": "phantomas",
"label": "Uses of @import",
diff --git a/lib/metadata/scoreProfileGeneric.json b/lib/metadata/scoreProfileGeneric.json
index 8a3b2d3..044db52 100644
--- a/lib/metadata/scoreProfileGeneric.json
+++ b/lib/metadata/scoreProfileGeneric.json
@@ -46,7 +46,8 @@
"policies": {
"cssRules": 2,
"cssComplexSelectors": 2,
- "cssComplexSelectorsByAttribute": 1.5
+ "cssComplexSelectorsByAttribute": 1.5,
+ "cssColors": 0.5
}
},
"badCSS": {
diff --git a/lib/rulesChecker.js b/lib/rulesChecker.js
index b82b7d7..bc570a7 100644
--- a/lib/rulesChecker.js
+++ b/lib/rulesChecker.js
@@ -65,7 +65,7 @@ var RulesChecker = function() {
if (policy.offendersTransformFn) {
try {
- offendersObj = policy.offendersTransformFn(offenders);
+ offendersObj = policy.offendersTransformFn(offenders, rule);
} catch(err) {
debug('Error while transforming offenders for %s', metricName);
debug(err);
diff --git a/test/core/customPoliciesTest.js b/test/core/customPoliciesTest.js
index 302b1c4..abfb601 100644
--- a/test/core/customPoliciesTest.js
+++ b/test/core/customPoliciesTest.js
@@ -404,20 +404,20 @@ describe('rulesChecker', function() {
results.should.deep.equals({});
- // If jQueryDifferentVersions is 0
+ // If jQueryVersionsLoaded is 0
results = rulesChecker.check({
"toolsResults": {
"phantomas": {
"metrics": {
"jQueryVersion": "1.6.0",
- "jQueryDifferentVersions": 0
+ "jQueryVersionsLoaded": 0
}
}
}
}, policies);
results.should.not.have.a.property('jQueryVersion');
- results.should.have.a.property('jQueryDifferentVersions');
- results.jQueryDifferentVersions.should.have.a.property('score').that.equals(100);
+ results.should.have.a.property('jQueryVersionsLoaded');
+ results.jQueryVersionsLoaded.should.have.a.property('score').that.equals(100);
// If there are more than 1 jQuery version
@@ -426,15 +426,15 @@ describe('rulesChecker', function() {
"phantomas": {
"metrics": {
"jQueryVersion": "1.6.0",
- "jQueryDifferentVersions": 2
+ "jQueryVersionsLoaded": 2
}
}
}
}, policies);
results.should.not.have.a.property('jQueryVersion');
- results.should.have.a.property('jQueryDifferentVersions');
- results.jQueryDifferentVersions.should.have.a.property('score').that.equals(0);
- results.jQueryDifferentVersions.should.have.a.property('abnormal').that.equals(true);
+ results.should.have.a.property('jQueryVersionsLoaded');
+ results.jQueryVersionsLoaded.should.have.a.property('score').that.equals(0);
+ results.jQueryVersionsLoaded.should.have.a.property('abnormal').that.equals(true);
});
From d5368e5f90efa026b6ab4c77130aa6ce636c2560 Mon Sep 17 00:00:00 2001
From: Loic Kartono
Date: Tue, 3 Feb 2015 10:51:48 +1100
Subject: [PATCH 20/54] Chore : Fix typo on policies
---
lib/metadata/policies.js | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/lib/metadata/policies.js b/lib/metadata/policies.js
index b2b70fd..6051996 100644
--- a/lib/metadata/policies.js
+++ b/lib/metadata/policies.js
@@ -186,7 +186,7 @@ var policies = {
"cssRules": {
"tool": "phantomas",
"label": "Rules count",
- "message": "Having a huge number of CSS rules hurts performances. If the number of CSS rules is higher than the number of DOM elements, there is clearly a problem.
Huge stylesheets generally occur when the different pages of a website load all the CSS, concatenated in a single stylesheet, even if a large part of the rules are page-specific. Solution is to create one main CSS file with global rules and one custom files per page.
",
+ "message": "Having a huge number of CSS rules hurts performances. If the number of CSS rules is higher than the number of DOM elements, there is clearly a problem.
Huge stylesheets generally occur when the different pages of a website load all the CSS, concatenated in a single stylesheet, even if a large part of the rules are page-specific. Solution is to create one main CSS file with global rules and one custom file per page.
",
"isOkThreshold": 500,
"isBadThreshold": 2500,
"isAbnormalThreshold": 4000
@@ -395,7 +395,7 @@ var policies = {
"notFound": {
"tool": "phantomas",
"label": "404 not found",
- "message": "404 errors are never cached, so each time a page ask for it, it hits se server. Even if it is behind a CDN or a reverse-proxy cache.
",
+ "message": "404 errors are never cached, so each time a page ask for it, it hits the server. Even if it is behind a CDN or a reverse-proxy cache.
",
"isOkThreshold": 0,
"isBadThreshold": 1,
"isAbnormalThreshold": 1
@@ -403,7 +403,7 @@ var policies = {
"closedConnections": {
"tool": "phantomas",
"label": "Connections closed",
- "message": "This counts the number of requests not keeping the connection alive (specifying \"Connection: close\" in the response headers). It is only counting a request if it is followed by another request on the same domain.
This is slowing down the next request, because the brower needs to open a new connection to the server, which means a additional round-trip.
Correct the problem by setting a Keep-Alive header on the guilty server.
",
+ "message": "This counts the number of requests not keeping the connection alive (specifying \"Connection: close\" in the response headers). It is only counting a request if it is followed by another request on the same domain.
This is slowing down the next request, because the brower needs to open a new connection to the server, which means an additional round-trip.
Correct the problem by setting a Keep-Alive header on the guilty server.
",
"isOkThreshold": 0,
"isBadThreshold": 8,
"isAbnormalThreshold": 20
From 798f295912b38394e69114d50a4c9a3868ef80ff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABl=20M=C3=A9tais?=
Date: Tue, 3 Feb 2015 20:23:09 +0100
Subject: [PATCH 21/54] Remove double jsHint check
---
Gruntfile.js | 1 -
screenshot.png | Bin 136058 -> 0 bytes
2 files changed, 1 deletion(-)
delete mode 100644 screenshot.png
diff --git a/Gruntfile.js b/Gruntfile.js
index 819db4f..9525960 100644
--- a/Gruntfile.js
+++ b/Gruntfile.js
@@ -330,7 +330,6 @@ module.exports = function(grunt) {
grunt.registerTask('test', [
'build',
- 'jshint',
'express:testSuite',
'clean:coverage',
'copy-test-server-settings',
diff --git a/screenshot.png b/screenshot.png
deleted file mode 100644
index b95be34e5942b55f1b1c1fc1bf5aca0d13422922..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 136058
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