Source code
Revision control
Copy as Markdown
Other Tools
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
"use strict";
const {
cssPropertiesSpec,
loader.lazyRequireGetter(
this,
"CSS_TYPES",
true
);
class CssPropertiesActor extends Actor {
constructor(conn, targetActor) {
super(conn, cssPropertiesSpec);
this.targetActor = targetActor;
}
getCSSDatabase() {
const properties = generateCssProperties(this.targetActor.window.document);
return { properties };
}
}
exports.CssPropertiesActor = CssPropertiesActor;
/**
* Generate the CSS properties object. Every key is the property name, while
* the values are objects that contain information about that property.
*
* @param {Document} doc
* @return {Object}
*/
function generateCssProperties(doc) {
const properties = {};
const propertyNames = InspectorUtils.getCSSPropertyNames({
includeAliases: true,
});
for (const name of propertyNames) {
// Get the list of CSS types this property supports.
const supports = [];
for (const type in CSS_TYPES) {
if (safeCssPropertySupportsType(name, type)) {
supports.push(type);
}
}
const values = InspectorUtils.getCSSValuesForProperty(name);
const subproperties = InspectorUtils.getSubpropertiesForCSSProperty(name);
properties[name] = {
isInherited: InspectorUtils.isInheritedProperty(doc, name),
values,
supports,
subproperties,
};
}
return properties;
}
exports.generateCssProperties = generateCssProperties;
/**
* Test if a CSS is property is known using server-code.
*
* @param {string} name
* @return {Boolean}
*/
function isCssPropertyKnown(name) {
try {
// If the property name is unknown, the cssPropertyIsShorthand
// will throw an exception. But if it is known, no exception will
// be thrown; so we just ignore the return value.
InspectorUtils.cssPropertyIsShorthand(name);
return true;
} catch (e) {
return false;
}
}
exports.isCssPropertyKnown = isCssPropertyKnown;
/**
* A wrapper for InspectorUtils.cssPropertySupportsType that ignores invalid
* properties.
*
* @param {String} name The property name.
* @param {number} type The type tested for support.
* @return {Boolean} Whether the property supports the type.
* If the property is unknown, false is returned.
*/
function safeCssPropertySupportsType(name, type) {
try {
return InspectorUtils.cssPropertySupportsType(name, type);
} catch (e) {
return false;
}
}