mirror of
https://gitlab.winehq.org/wine/wine-gecko.git
synced 2024-09-13 09:24:08 -07:00
619 lines
18 KiB
Plaintext
619 lines
18 KiB
Plaintext
# 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
|
|
# file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
|
|
# DOM Bindings Configuration.
|
|
#
|
|
# The WebIDL interfaces are defined in dom/webidl. For each such interface, there
|
|
# is a corresponding entry in the configuration table below. The configuration
|
|
# table maps each interface name to a |descriptor| or list of |descriptor|s.
|
|
#
|
|
# Valid fields for all descriptors:
|
|
# * nativeType - The native type (concrete class or XPCOM interface) that
|
|
# instances of this interface will unwrap to. If not
|
|
# specified, defaults to "mozilla::dom::InterfaceName" for
|
|
# non-worker non-external-or-callback interfaces, to
|
|
# "mozilla::dom::workers::InterfaceName" for worker
|
|
# non-external interfaces, to 'nsIDOM' followed by the
|
|
# interface name for non-worker external-or-callback
|
|
# interfaces, and to "JSObject" for worker external-or-callback
|
|
# interfaces.
|
|
# * headerFile - The file in which the nativeType is declared (defaults
|
|
# to an educated guess).
|
|
# * castable - Indicates whether the value in the wrapper can be cast to
|
|
# nativeType, or whether it needs to be QI-ed (defaults to True
|
|
# for everything but callback interfaces and external interfaces,
|
|
# for which it defaults to false and is not allowed to be set
|
|
# at all).
|
|
# * concrete - Indicates whether there exist objects with this interface as
|
|
# their primary interface (defaults to True).
|
|
# * prefable - Indicates whether this bindings should be disabled if the
|
|
# global pref for Web IDL bindings is set to false. This is a
|
|
# risk mitigation strategy and it will cause all of the Web IDL
|
|
# bindings marked as prefable to fall back to the xpconnect
|
|
# bindings in case something goes wrong. This defaults to False.
|
|
# Setting this on objects which only have Web IDL bindings does
|
|
# not make any sense.
|
|
# Cannot be set on external interfaces.
|
|
# * workers - Indicates whether the descriptor is intended to be used for
|
|
# worker threads (defaults to false).
|
|
# * customTrace - The native class will use a custom trace hook (defaults to
|
|
# true for workers, false otherwise).
|
|
# * customFinalize - The native class will use a custom finalize hook
|
|
# (defaults to true for workers, false otherwise).
|
|
# * notflattened - The native type does not have nsIClassInfo, so when
|
|
# wrapping it the right IID needs to be passed in.
|
|
# * register - True if this binding should be registered. Defaults to true.
|
|
# * binaryNames - Dict for mapping method and attribute names to different
|
|
# names when calling the native methods (defaults to an empty
|
|
# dict). The keys are the property names as they appear in the
|
|
# .webidl file and the values are the names as they should be
|
|
# in the WebIDL.
|
|
# * wrapperCache: True if this object is a wrapper cache. Objects that are
|
|
# not can only be returned from a limited set of methods,
|
|
# cannot be prefable, and must ensure that they disallow
|
|
# XPConnect wrapping. Always true for worker descriptors.
|
|
# Defaults to true.
|
|
# * nativeOwnership: Describes how the native object is held. 4 possible
|
|
# types: worker object ("worker"), non-refcounted object
|
|
# ("owned"), refcounted non-nsISupports object
|
|
# ("refcounted") or nsISupports ("nsisupports").
|
|
# Non-refcounted objects need to inherit from
|
|
# mozilla::dom::NonRefcountedDOMObject and preferably use
|
|
# MOZ_COUNT_CTOR/MOZ_COUNT_DTOR in their
|
|
# constructor/destructor so they participate in leak
|
|
# logging.
|
|
# This mostly determines how the finalizer releases the
|
|
# binding's hold on the native object. For a worker object
|
|
# it'll call Release, for a non-refcounted object it'll
|
|
# call delete through XPConnect's deferred finalization
|
|
# mechanism, for a refcounted object it'll call Release
|
|
# through XPConnect's deferred finalization mechanism.
|
|
# Always "worker" for worker descriptors. Defaults to
|
|
# "nsisupports".
|
|
#
|
|
# The following fields are either a string, an array (defaults to an empty
|
|
# array) or a dictionary with three possible keys (all, getterOnly and
|
|
# setterOnly) each having such an array as the value
|
|
#
|
|
# * implicitJSContext - attributes and methods specified in the .webidl file
|
|
# that require a JSContext as the first argument
|
|
# * resultNotAddRefed - attributes and methods specified in the .webidl file
|
|
# that do not AddRef the return value
|
|
|
|
DOMInterfaces = {
|
|
|
|
'mozAudioContext': {
|
|
'nativeType': 'AudioContext',
|
|
'implicitJSContext': [ 'createBuffer' ],
|
|
},
|
|
|
|
'AudioNode' : {
|
|
'concrete': False,
|
|
},
|
|
|
|
'AudioSourceNode': {
|
|
'concrete': False,
|
|
},
|
|
|
|
'Blob': [
|
|
{
|
|
'headerFile': 'nsIDOMFile.h',
|
|
},
|
|
{
|
|
'workers': True,
|
|
}],
|
|
|
|
'CanvasRenderingContext2D': [
|
|
{
|
|
'nativeType': 'nsCanvasRenderingContext2DAzure',
|
|
# Making this non-prefable requires that we ensure that nothing takes this
|
|
# type as an argument or that the non-Azure variant is removed.
|
|
'prefable': True,
|
|
'implicitJSContext': [
|
|
'createImageData', 'getImageData', 'putImageData', 'strokeStyle',
|
|
'fillStyle', 'mozDash'
|
|
],
|
|
'resultNotAddRefed': [ 'canvas' ],
|
|
'binaryNames': {
|
|
'mozImageSmoothingEnabled': 'imageSmoothingEnabled',
|
|
'mozFillRule': 'fillRule'
|
|
}
|
|
}],
|
|
|
|
'ClientRectList': [
|
|
{
|
|
'nativeType': 'nsClientRectList',
|
|
'headerFile': 'nsClientRect.h',
|
|
'prefable': True,
|
|
'resultNotAddRefed': [ 'item' ]
|
|
}],
|
|
|
|
'CSS2Properties': {
|
|
'nativeType': 'nsDOMCSSDeclaration',
|
|
'prefable': True,
|
|
},
|
|
|
|
'CSSStyleDeclaration': {
|
|
'nativeType': 'nsICSSDeclaration',
|
|
'prefable': True
|
|
},
|
|
|
|
'Document': [
|
|
{
|
|
'nativeType': 'nsIDocument',
|
|
},
|
|
{
|
|
'workers': True,
|
|
}],
|
|
|
|
'DOMSettableTokenList': [
|
|
{
|
|
'nativeType': 'nsDOMSettableTokenList',
|
|
'prefable': True,
|
|
'binaryNames': {
|
|
'__stringifier': 'Stringify'
|
|
}
|
|
}],
|
|
|
|
'DOMTokenList': [
|
|
{
|
|
'nativeType': 'nsDOMTokenList',
|
|
'prefable': True,
|
|
'binaryNames': {
|
|
'__stringifier': 'Stringify'
|
|
}
|
|
}],
|
|
|
|
'Event': [
|
|
{
|
|
'workers': True,
|
|
}],
|
|
|
|
'EventListener': [
|
|
{
|
|
'workers': True,
|
|
}],
|
|
|
|
'EventTarget': [
|
|
{
|
|
'nativeType': 'nsDOMEventTargetHelper',
|
|
'hasInstanceInterface': 'nsIDOMEventTarget',
|
|
'concrete': False,
|
|
'prefable': True,
|
|
},
|
|
{
|
|
'workers': True,
|
|
'concrete': False
|
|
}],
|
|
|
|
'FileList': [
|
|
{
|
|
'nativeType': 'nsDOMFileList',
|
|
'headerFile': 'nsDOMFile.h',
|
|
'prefable': True,
|
|
'resultNotAddRefed': [ 'item' ]
|
|
}],
|
|
|
|
'FileReaderSync': {
|
|
'workers': True,
|
|
},
|
|
|
|
'FormData': [
|
|
{
|
|
'workers': True,
|
|
}],
|
|
|
|
'HTMLCollection': [
|
|
{
|
|
'nativeType': 'nsIHTMLCollection',
|
|
'prefable': True,
|
|
'resultNotAddRefed': [ 'item' ]
|
|
}],
|
|
|
|
'HTMLOptionsCollection': [
|
|
{
|
|
'nativeType': 'nsHTMLOptionCollection',
|
|
'headerFile': 'nsHTMLSelectElement.h',
|
|
'prefable': True,
|
|
'resultNotAddRefed': [ 'item' ],
|
|
'binaryNames': {
|
|
'__indexedsettercreator': 'SetOption'
|
|
}
|
|
}],
|
|
|
|
'HTMLPropertiesCollection': [
|
|
{
|
|
'headerFile': 'HTMLPropertiesCollection.h',
|
|
'prefable': True,
|
|
'resultNotAddRefed': [ 'item', 'namedItem', 'names' ]
|
|
}],
|
|
|
|
'IID': [
|
|
{
|
|
'nativeType': 'nsIJSIID',
|
|
'headerFile': 'xpcjsid.h',
|
|
},
|
|
{
|
|
'workers': True,
|
|
}],
|
|
|
|
'InputStream': [
|
|
{
|
|
'nativeType': 'nsIInputStream',
|
|
'notflattened': True
|
|
},
|
|
{
|
|
'workers': True,
|
|
}],
|
|
|
|
'MozChannel': [
|
|
{
|
|
'nativeType': 'nsIChannel',
|
|
'notflattened': True
|
|
},
|
|
{
|
|
'workers': True,
|
|
}],
|
|
|
|
'NodeList': [
|
|
{
|
|
'nativeType': 'nsINodeList',
|
|
'prefable': True,
|
|
'resultNotAddRefed': [ 'item' ]
|
|
}],
|
|
|
|
'PaintRequestList': [
|
|
{
|
|
'nativeType': 'nsPaintRequestList',
|
|
'headerFile': 'nsPaintRequest.h',
|
|
'prefable': True,
|
|
'resultNotAddRefed': [ 'item' ]
|
|
}],
|
|
|
|
'Performance': {
|
|
'nativeType': 'nsPerformance',
|
|
'resultNotAddRefed': [ 'timing', 'navigation' ]
|
|
},
|
|
|
|
'PerformanceTiming': {
|
|
'nativeType': 'nsPerformanceTiming',
|
|
'headerFile': 'nsPerformance.h'
|
|
},
|
|
|
|
'PerformanceNavigation': {
|
|
'nativeType': 'nsPerformanceNavigation',
|
|
'headerFile': 'nsPerformance.h'
|
|
},
|
|
|
|
'PropertyNodeList': [
|
|
{
|
|
'headerFile': 'HTMLPropertiesCollection.h',
|
|
'prefable': True,
|
|
'resultNotAddRefed': [ 'item' ]
|
|
}],
|
|
|
|
'SVGLengthList': [
|
|
{
|
|
'nativeType': 'mozilla::DOMSVGLengthList',
|
|
'headerFile': 'DOMSVGLengthList.h',
|
|
'prefable': True,
|
|
'resultNotAddRefed': [ 'getItem' ]
|
|
}],
|
|
|
|
'SVGNumberList': [
|
|
{
|
|
'nativeType': 'mozilla::DOMSVGNumberList',
|
|
'headerFile': 'DOMSVGNumberList.h',
|
|
'prefable': True,
|
|
'resultNotAddRefed': [ 'getItem' ]
|
|
}],
|
|
|
|
'SVGPathSegList': [
|
|
{
|
|
'nativeType': 'mozilla::DOMSVGPathSegList',
|
|
'headerFile': 'DOMSVGPathSegList.h',
|
|
'prefable': True,
|
|
'resultNotAddRefed': [ 'getItem' ]
|
|
}],
|
|
|
|
'SVGPointList': [
|
|
{
|
|
'nativeType': 'mozilla::DOMSVGPointList',
|
|
'headerFile': 'DOMSVGPointList.h',
|
|
'prefable': True,
|
|
'resultNotAddRefed': [ 'getItem' ]
|
|
}],
|
|
|
|
'SVGTransformList': [
|
|
{
|
|
'nativeType': 'mozilla::DOMSVGTransformList',
|
|
'headerFile': 'DOMSVGTransformList.h',
|
|
'prefable': True,
|
|
'resultNotAddRefed': [ 'getItem' ]
|
|
}],
|
|
|
|
'TextEncoder': {
|
|
'headerFile': 'mozilla/dom/TextEncoder.h',
|
|
'implicitJSContext': [ 'encode' ],
|
|
},
|
|
|
|
'TextDecoder': {
|
|
'headerFile': 'mozilla/dom/TextDecoder.h',
|
|
},
|
|
|
|
'WebGLBuffer': {
|
|
'nativeType': 'mozilla::WebGLBuffer',
|
|
'headerFile': 'WebGLContext.h'
|
|
},
|
|
|
|
'WebGLExtensionCompressedTextureATC': {
|
|
'nativeType': 'mozilla::WebGLExtensionCompressedTextureATC',
|
|
'headerFile': 'WebGLExtensions.h'
|
|
},
|
|
|
|
'WebGLExtensionCompressedTexturePVRTC': {
|
|
'nativeType': 'mozilla::WebGLExtensionCompressedTexturePVRTC',
|
|
'headerFile': 'WebGLExtensions.h'
|
|
},
|
|
|
|
'WebGLExtensionCompressedTextureS3TC': {
|
|
'nativeType': 'mozilla::WebGLExtensionCompressedTextureS3TC',
|
|
'headerFile': 'WebGLExtensions.h'
|
|
},
|
|
|
|
'WebGLExtensionDepthTexture': {
|
|
'nativeType': 'mozilla::WebGLExtensionDepthTexture',
|
|
'headerFile': 'WebGLExtensions.h'
|
|
},
|
|
|
|
'WebGLExtensionLoseContext': {
|
|
'nativeType': 'mozilla::WebGLExtensionLoseContext',
|
|
'headerFile': 'WebGLExtensions.h'
|
|
},
|
|
|
|
'WebGLExtensionStandardDerivatives': {
|
|
'nativeType': 'mozilla::WebGLExtensionStandardDerivatives',
|
|
'headerFile': 'WebGLExtensions.h'
|
|
},
|
|
|
|
'WebGLExtensionTextureFilterAnisotropic': {
|
|
'nativeType': 'mozilla::WebGLExtensionTextureFilterAnisotropic',
|
|
'headerFile': 'WebGLExtensions.h'
|
|
},
|
|
|
|
'WebGLExtensionTextureFloat': {
|
|
'nativeType': 'mozilla::WebGLExtensionTextureFloat',
|
|
'headerFile': 'WebGLExtensions.h'
|
|
},
|
|
|
|
'WebGLFramebuffer': {
|
|
'nativeType': 'mozilla::WebGLFramebuffer',
|
|
'headerFile': 'WebGLContext.h'
|
|
},
|
|
|
|
'WebGLProgram': {
|
|
'nativeType': 'mozilla::WebGLProgram',
|
|
'headerFile': 'WebGLContext.h'
|
|
},
|
|
|
|
'WebGLRenderbuffer': {
|
|
'nativeType': 'mozilla::WebGLRenderbuffer',
|
|
'headerFile': 'WebGLContext.h'
|
|
},
|
|
|
|
'WebGLRenderingContext': {
|
|
'nativeType': 'mozilla::WebGLContext',
|
|
'headerFile': 'WebGLContext.h',
|
|
'resultNotAddRefed': [ 'canvas', 'getContextAttributes', 'getExtension',
|
|
'getAttachedShaders' ],
|
|
'implicitJSContext': [ 'texImage2D', 'texSubImage2D' ],
|
|
},
|
|
|
|
'WebGLShader': {
|
|
'nativeType': 'mozilla::WebGLShader',
|
|
'headerFile': 'WebGLContext.h'
|
|
},
|
|
|
|
'WebGLShaderPrecisionFormat': {
|
|
'nativeType': 'mozilla::WebGLShaderPrecisionFormat',
|
|
'headerFile': 'WebGLContext.h',
|
|
'wrapperCache': False
|
|
},
|
|
|
|
'WebGLTexture': {
|
|
'nativeType': 'mozilla::WebGLTexture',
|
|
'headerFile': 'WebGLContext.h'
|
|
},
|
|
|
|
'WebGLUniformLocation': {
|
|
'nativeType': 'mozilla::WebGLUniformLocation',
|
|
'headerFile': 'WebGLContext.h',
|
|
'wrapperCache': False
|
|
},
|
|
|
|
'XMLHttpRequest': [
|
|
{
|
|
'nativeType': 'nsXMLHttpRequest',
|
|
'implicitJSContext': [ 'constructor', ],
|
|
'resultNotAddRefed': [ 'upload', 'responseXML' ]
|
|
},
|
|
{
|
|
'workers': True,
|
|
}],
|
|
|
|
'XMLHttpRequestEventTarget': [
|
|
{
|
|
'nativeType': 'nsXHREventTarget',
|
|
'headerFile': 'nsXMLHttpRequest.h',
|
|
'concrete': False,
|
|
'prefable': True,
|
|
},
|
|
{
|
|
'workers': True,
|
|
'concrete': False,
|
|
}],
|
|
|
|
'XMLHttpRequestUpload': [
|
|
{
|
|
'nativeType': 'nsXMLHttpRequestUpload',
|
|
'headerFile': 'nsXMLHttpRequest.h',
|
|
'prefable': True
|
|
},
|
|
{
|
|
'workers': True,
|
|
}],
|
|
|
|
'WebSocket': [
|
|
{
|
|
'headerFile': 'WebSocket.h',
|
|
'implicitJSContext': [ 'constructor' ]
|
|
}],
|
|
|
|
####################################
|
|
# Test Interfaces of various sorts #
|
|
####################################
|
|
|
|
'TestInterface' : {
|
|
'headerFile': 'TestBindingHeader.h',
|
|
'register': False,
|
|
'resultNotAddRefed': [ 'receiveWeakSelf', 'receiveWeakNullableSelf',
|
|
'receiveWeakOther', 'receiveWeakNullableOther',
|
|
'receiveWeakExternal', 'receiveWeakNullableExternal',
|
|
'ReceiveWeakCallbackInterface',
|
|
'ReceiveWeakNullableCallbackInterface',
|
|
'receiveWeakCastableObjectSequence',
|
|
'receiveWeakNullableCastableObjectSequence',
|
|
'receiveWeakCastableObjectNullableSequence',
|
|
'receiveWeakNullableCastableObjectNullableSequence' ],
|
|
'binaryNames': { 'methodRenamedFrom': 'methodRenamedTo',
|
|
'attributeGetterRenamedFrom': 'attributeGetterRenamedTo',
|
|
'attributeRenamedFrom': 'attributeRenamedTo' }
|
|
},
|
|
|
|
'TestNonCastableInterface' : {
|
|
'headerFile': 'TestBindingHeader.h',
|
|
'register': False,
|
|
'castable': False
|
|
},
|
|
|
|
'TestExternalInterface' : {
|
|
'nativeType': 'mozilla::dom::TestExternalInterface',
|
|
'headerFile': 'TestBindingHeader.h',
|
|
'register': False
|
|
},
|
|
|
|
'TestNonWrapperCacheInterface' : {
|
|
'headerFile': 'TestBindingHeader.h',
|
|
'register': False,
|
|
'wrapperCache': False
|
|
},
|
|
|
|
'TestCallbackInterface': {
|
|
'nativeType': 'mozilla::dom::TestCallbackInterface',
|
|
'headerFile': 'TestBindingHeader.h',
|
|
'register': False
|
|
},
|
|
|
|
'IndirectlyImplementedInterface': {
|
|
'headerFile': 'TestBindingHeader.h',
|
|
'register': False,
|
|
'castable': False,
|
|
'concrete': False
|
|
},
|
|
|
|
'OnlyForUseInConstructor' : {
|
|
'headerFile': 'TestBindingHeader.h',
|
|
'register': False
|
|
},
|
|
|
|
|
|
'TestIndexedGetterInterface' : {
|
|
'headerFile': 'TestBindingHeader.h',
|
|
'register': False
|
|
},
|
|
|
|
'TestNamedGetterInterface' : {
|
|
'headerFile': 'TestBindingHeader.h',
|
|
'register': False
|
|
},
|
|
|
|
'TestIndexedAndNamedGetterInterface' : {
|
|
'headerFile': 'TestBindingHeader.h',
|
|
'register': False
|
|
},
|
|
|
|
'TestIndexedSetterInterface' : {
|
|
'headerFile': 'TestBindingHeader.h',
|
|
'register': False
|
|
},
|
|
|
|
'TestNamedSetterInterface' : {
|
|
'headerFile': 'TestBindingHeader.h',
|
|
'register': False
|
|
},
|
|
|
|
'TestIndexedAndNamedSetterInterface' : {
|
|
'headerFile': 'TestBindingHeader.h',
|
|
'register': False
|
|
},
|
|
|
|
'TestIndexedAndNamedGetterAndSetterInterface' : {
|
|
'headerFile': 'TestBindingHeader.h',
|
|
'register': False,
|
|
'binaryNames': { '__stringifier': 'Stringify' }
|
|
},
|
|
}
|
|
|
|
# These are temporary, until they've been converted to use new DOM bindings
|
|
def addExternalIface(iface, nativeType=None, headerFile=None):
|
|
domInterface = {
|
|
'concrete': False
|
|
}
|
|
if not nativeType is None:
|
|
domInterface['nativeType'] = nativeType
|
|
if not headerFile is None:
|
|
domInterface['headerFile'] = headerFile
|
|
DOMInterfaces[iface] = domInterface
|
|
|
|
# If you add one of these, you need to make sure nsDOMQS.h has the relevant
|
|
# macros added for it
|
|
def addExternalHTMLElement(element):
|
|
nativeElement = 'ns' + element
|
|
addExternalIface(element, nativeType=nativeElement,
|
|
headerFile=nativeElement + '.h')
|
|
|
|
addExternalHTMLElement('HTMLCanvasElement')
|
|
addExternalHTMLElement('HTMLImageElement')
|
|
addExternalHTMLElement('HTMLOptionElement')
|
|
addExternalHTMLElement('HTMLOptGroupElement')
|
|
addExternalHTMLElement('HTMLVideoElement')
|
|
addExternalIface('CanvasGradient', headerFile='nsIDOMCanvasRenderingContext2D.h')
|
|
addExternalIface('CanvasPattern', headerFile='nsIDOMCanvasRenderingContext2D.h')
|
|
addExternalIface('ClientRect')
|
|
addExternalIface('CSSRule')
|
|
addExternalIface('CSSValue')
|
|
addExternalIface('DOMStringList', nativeType='nsDOMStringList',
|
|
headerFile='nsDOMLists.h')
|
|
addExternalIface('Element', nativeType='nsGenericElement')
|
|
addExternalIface('File')
|
|
addExternalIface('HitRegionOptions', nativeType='nsISupports')
|
|
addExternalIface('HTMLElement')
|
|
addExternalIface('ImageData', nativeType='mozilla::dom::ImageData')
|
|
addExternalIface('Node', nativeType='nsINode')
|
|
addExternalIface('PaintRequest')
|
|
addExternalIface('SVGLength')
|
|
addExternalIface('SVGMatrix')
|
|
addExternalIface('SVGNumber')
|
|
addExternalIface('SVGPathSeg')
|
|
addExternalIface('SVGPoint')
|
|
addExternalIface('SVGTransform')
|
|
addExternalIface('TextMetrics', headerFile='nsIDOMCanvasRenderingContext2D.h')
|
|
addExternalIface('Touch', headerFile='nsIDOMTouchEvent.h')
|
|
addExternalIface('WebGLActiveInfo', nativeType='mozilla::WebGLActiveInfo',
|
|
headerFile='WebGLContext.h')
|
|
addExternalIface('WebGLContextAttributes', nativeType='JSObject',
|
|
headerFile='jsapi.h')
|
|
addExternalIface('Window')
|
|
addExternalIface('XULElement')
|