scripts.mdnreader.MDNReader Class Reference

Inheritance diagram for scripts.mdnreader.MDNReader:

Public Member Functions
	__init__ (self)
	is_compatible (self, attribute)
	set_compatible (self, attribute, compatible)

Protected Member Functions
	_get_attr_compatibility (self, compat_data)

Protected Attributes
	_compat_overrides

Static Protected Attributes
	_BROWSER_COMPAT_DATA = _get_browser_compat_data()

Detailed Description

Definition at line 255 of file mdnreader.py.

Constructor & Destructor Documentation

__init__()

scripts.mdnreader.MDNReader.__init__

(

self

)

Definition at line 259 of file mdnreader.py.

    def __init__(self):
        self._compat_overrides = {}
 

Member Function Documentation

_get_attr_compatibility()

scripts.mdnreader.MDNReader._get_attr_compatibility (   self,   compat_data  )

protected

Definition at line 262 of file mdnreader.py.

    def _get_attr_compatibility(self, compat_data):
        # Parse schema syntax of MDN data:
        # https://github.com/mdn/browser-compat-data/blob/master/schemas/compat-data.schema.json
 
        # For now, we will require support for browsers since the last IDL roll.
        # TODO(srujzs): Determine if this is too conservative.
        browser_version_map = {
            'chrome': '63',
            'firefox': '57',
            'safari': '11',
            # We still support the latest version of IE.
            'ie': '11',
            'opera': '50',
        }
        for browser in browser_version_map.keys():
            support_data = compat_data[_SUPPORT_KEY]
            if browser not in support_data:
                return False
            support_statement = support_data[browser]
            if not _is_simple_support_statement(support_statement):
                return False
            version = support_statement[_VERSION_ADDED_KEY]
            # Compare version strings, target should be the more strict version.
            target = browser_version_map[browser]
            if _unify_versions(version, target) != target:
                return False
 
            # If the attribute is experimental, we assume it's not compatible.
            status_data = compat_data[_STATUS_KEY]
            if _EXPERIMENTAL_KEY in status_data and status_data[_EXPERIMENTAL_KEY]:
                return False
        return True
 

is_compatible()

scripts.mdnreader.MDNReader.is_compatible	(		self,
			attribute
	)

Definition at line 295 of file mdnreader.py.

    def is_compatible(self, attribute):
        # Since capitalization isn't consistent across MDN and WebCore, we
        # compare lowercase equivalents for interface and attribute names.
        interface = attribute.doc_js_interface_name.lower()
        if interface in self._BROWSER_COMPAT_DATA and attribute.id and len(
                attribute.id) > 0:
            interface_dict = self._BROWSER_COMPAT_DATA[interface]
            id_name = attribute.id.lower()
            secure_context_key = 'isSecureContext'
            if interface in self._compat_overrides and id_name in self._compat_overrides[
                    interface]:
                return self._compat_overrides[interface][id_name]
            elif secure_context_key in interface_dict:
                # If the interface requires a secure context, all attributes are
                # implicitly incompatible.
                return False
            elif id_name in interface_dict:
                id_data = interface_dict[id_name]
                return self._get_attr_compatibility(id_data[_COMPAT_KEY])
            else:
                # Might be an attribute that is defined in a parent interface.
                # We defer until attribute emitting to determine if this is the
                # case. Otherwise, return None.
                pass
        return None
 

set_compatible()

scripts.mdnreader.MDNReader.set_compatible	(		self,
			attribute,
			compatible
	)

Definition at line 321 of file mdnreader.py.

    def set_compatible(self, attribute, compatible):
        # Override value in the MDN browser compatibility data.
        if not compatible in [True, False, None]:
            raise ValueError('Cannot set a non-boolean object for compatible')
        interface = attribute.doc_js_interface_name.lower()
        if not interface in self._compat_overrides:
            self._compat_overrides[interface] = {}
        if attribute.id and len(attribute.id) > 0:
            id_name = attribute.id.lower()
            self._compat_overrides[interface][id_name] = compatible

Member Data Documentation

_BROWSER_COMPAT_DATA

scripts.mdnreader.MDNReader._BROWSER_COMPAT_DATA = _get_browser_compat_data()

staticprotected

Definition at line 257 of file mdnreader.py.

_compat_overrides

scripts.mdnreader.MDNReader._compat_overrides

protected

Definition at line 260 of file mdnreader.py.

---

The documentation for this class was generated from the following file:

• third_party/dart-lang/sdk/tools/dom/scripts/mdnreader.py