dom/base/UseCounters.conf

   1 // This Source Code Form is subject to the terms of the Mozilla Public
   2 // License, v. 2.0. If a copy of the MPL was not distributed with this
   3 // file, You can obtain one at http://mozilla.org/MPL/2.0/.
   4
   5 // This file defines a list of use counters, which are things that can
   6 // record usage of Web platform features and then report this information
   7 // through Telemetry.
   8 //
   9 // The format of this file is very strict.  Each line can be:
  10 //
  11 //   (a) a blank line
  12 //
  13 //   (b) a comment, which is a line that begins with "//"
  14 //
  15 //   (c) one of three possible use counter declarations:
  16 //
  17 //         method <IDL interface name>.<IDL operation name>
  18 //         attribute <IDL interface name>.<IDL attribute name>
  19 //         custom <any valid identifier> <description>
  20 //
  21 // The <description> for custom counters will be appended to "Whether a document "
  22 // or "Whether a page ", so phrase it appropriately.  For instance, "constructs a
  23 // Foo object" or "calls Document.bar('some value')".  It may contain any
  24 // character (including whitespace).
  25 //
  26 // To actually cause use counters to be incremented, DOM methods
  27 // and attributes must have a [UseCounter] extended attribute in
  28 // the Web IDL file.
  29 //
  30 // Custom counters are incremented when
  31 // SetUseCounter(eUseCounter_custom_MyName) is called on a Document object.
  32 //
  33 // You might reasonably ask why we have this file and we require
  34 // annotating things with [UseCounter] in the relevant WebIDL file as
  35 // well.  Generating things from bindings codegen and ensuring all the
  36 // dependencies were correct would have been rather difficult.
  37
  38 method SVGSVGElement.getElementById
  39 attribute SVGSVGElement.currentScale
  40
  41 // Push API
  42 method PushManager.subscribe
  43 method PushSubscription.unsubscribe
  44
  45 // window.sidebar
  46 attribute Window.sidebar
  47
  48 // AppCache API
  49 method OfflineResourceList.swapCache
  50 method OfflineResourceList.update
  51 attribute OfflineResourceList.status
  52 attribute OfflineResourceList.onchecking
  53 attribute OfflineResourceList.onerror
  54 attribute OfflineResourceList.onnoupdate
  55 attribute OfflineResourceList.ondownloading
  56 attribute OfflineResourceList.onprogress
  57 attribute OfflineResourceList.onupdateready
  58 attribute OfflineResourceList.oncached
  59 attribute OfflineResourceList.onobsolete
  60
  61 // Non-standard IndexedDB API
  62 method IDBDatabase.createMutableFile
  63 method IDBMutableFile.open
  64
  65 // DataTransfer API (gecko-only methods)
  66 method DataTransfer.addElement
  67 attribute DataTransfer.mozItemCount
  68 attribute DataTransfer.mozCursor
  69 method DataTransfer.mozTypesAt
  70 method DataTransfer.mozClearDataAt
  71 method DataTransfer.mozSetDataAt
  72 method DataTransfer.mozGetDataAt
  73 attribute DataTransfer.mozUserCancelled
  74 attribute DataTransfer.mozSourceNode
  75
  76 // Marquee events
  77 custom onstart sets a <marquee> onstart event listener
  78 custom onbounce sets a <marquee> onbounce event listener
  79 custom onfinish sets a <marquee> onfinish event listener
  80
  81 // Element non-standard events
  82 custom onoverflow sets an element onoverflow event listener
  83 custom onunderflow sets an element onunderflow event listener
  84
  85 // JavaScript feature usage
  86 custom JS_asmjs uses asm.js
  87 custom JS_wasm uses WebAssembly
  88 custom JS_wasm_duplicate_imports uses duplicate imports in WebAssembly
  89
  90 // Console API
  91 method console.assert
  92 method console.clear
  93 method console.count
  94 method console.countReset
  95 method console.debug
  96 method console.error
  97 method console.info
  98 method console.log
  99 method console.table
 100 method console.trace
 101 method console.warn
 102 method console.dir
 103 method console.dirxml
 104 method console.group
 105 method console.groupCollapsed
 106 method console.groupEnd
 107 method console.time
 108 method console.timeLog
 109 method console.timeEnd
 110 method console.exception
 111 method console.timeStamp
 112 method console.profile
 113 method console.profileEnd
 114
 115 // document.open information
 116 custom DocumentOpen calls document.open in a way that creates a new Window object
 117
 118 // HTMLDocument named getter
 119 custom HTMLDocumentNamedGetterHit calls to the named getter on HTMLDocument that find something via the name lookup
 120
 121 custom FilteredCrossOriginIFrame cross-origin <iframe> within a CSS/SVG filter
 122
 123 custom ContentUrlOnImageContent how often bug 1484928 can cause trouble.
 124
 125 // Custom Elements
 126 method CustomElementRegistry.define
 127
 128 // Shadow DOM
 129 method Element.attachShadow
 130
 131 // Non-standard capture methods
 132 method Element.setCapture
 133 method Element.releaseCapture
 134
 135 // Media Device Access
 136 method MediaDevices.enumerateDevices
 137 custom EnumerateDevicesInsec calls MediaDevices.enumerateDevices from an insecure context
 138 custom EnumerateDevicesUnfocused calls MediaDevices.enumerateDevices from a unfocused document
 139 method MediaDevices.getUserMedia
 140 method Navigator.mozGetUserMedia
 141 custom GetUserMediaUnfocused calls MediaDevices.getUserMedia from an unfocused document
 142 custom GetUserMediaInsec calls MediaDevices.getUserMedia from an insecure context
 143 custom MozGetUserMediaInsec calls Navigator.mozGetUserMedia from an insecure context
 144 method MediaDevices.getDisplayMedia
 145
 146 // Non-standard Document.mozSetImageElement.
 147 method Document.mozSetImageElement
 148
 149 // Non-standard Window.DOMMouseScroll and MozMousePixelScroll
 150 custom ondommousescroll sets DOMMouseScroll event listener
 151 custom onmozmousepixelscroll sets MozMousePixelScroll event listener
 152
 153 custom PercentageStrokeWidthInSVG whether percentage stroke-width is used in SVG elements (excluding <text>)
 154 custom PercentageStrokeWidthInSVGText whether percentage stroke-width is used in SVG <text>
 155
 156 // Missing-property use counters.  We claim these are "method" use
 157 // counters, because we don't need a separate description string for
 158 // them and we only need one use counter, not a getter/setter pair.
 159 method HTMLDocument.adoptedStyleSheets
 160 method HTMLDocument.caretRangeFromPoint
 161 method HTMLDocument.clear
 162 method HTMLDocument.exitPictureInPicture
 163 method HTMLDocument.featurePolicy
 164 method HTMLDocument.onbeforecopy
 165 method HTMLDocument.onbeforecut
 166 method HTMLDocument.onbeforepaste
 167 method HTMLDocument.oncancel
 168 method HTMLDocument.onfreeze
 169 method HTMLDocument.onmousewheel
 170 method HTMLDocument.onresume
 171 method HTMLDocument.onsearch
 172 method HTMLDocument.onsecuritypolicyviolation
 173 method HTMLDocument.onwebkitfullscreenchange
 174 method HTMLDocument.onwebkitfullscreenerror
 175 method HTMLDocument.pictureInPictureElement
 176 method HTMLDocument.pictureInPictureEnabled
 177 method HTMLDocument.registerElement
 178 method HTMLDocument.wasDiscarded
 179 method HTMLDocument.webkitCancelFullScreen
 180 method HTMLDocument.webkitCurrentFullScreenElement
 181 method HTMLDocument.webkitExitFullscreen
 182 method HTMLDocument.webkitFullscreenElement
 183 method HTMLDocument.webkitFullscreenEnabled
 184 method HTMLDocument.webkitHidden
 185 method HTMLDocument.webkitIsFullScreen
 186 method HTMLDocument.webkitVisibilityState
 187 method HTMLDocument.xmlEncoding
 188 method HTMLDocument.xmlStandalone
 189 method HTMLDocument.xmlVersion
 190 method Window.AbsoluteOrientationSensor
 191 method Window.Accelerometer
 192 method Window.ApplicationCache
 193 method Window.ApplicationCacheErrorEvent
 194 method Window.Atomics
 195 method Window.AudioParamMap
 196 method Window.AudioWorklet
 197 method Window.AudioWorkletNode
 198 method Window.BackgroundFetchManager
 199 method Window.BackgroundFetchRecord
 200 method Window.BackgroundFetchRegistration
 201 method Window.BeforeInstallPromptEvent
 202 method Window.Bluetooth
 203 method Window.BluetoothCharacteristicProperties
 204 method Window.BluetoothDevice
 205 method Window.BluetoothRemoteGATTCharacteristic
 206 method Window.BluetoothRemoteGATTDescriptor
 207 method Window.BluetoothRemoteGATTServer
 208 method Window.BluetoothRemoteGATTService
 209 method Window.BluetoothUUID
 210 method Window.CanvasCaptureMediaStreamTrack
 211 method Window.chrome
 212 method Window.clientInformation
 213 method Window.ClipboardItem
 214 method Window.CSSImageValue
 215 method Window.CSSKeywordValue
 216 method Window.CSSMathInvert
 217 method Window.CSSMathMax
 218 method Window.CSSMathMin
 219 method Window.CSSMathNegate
 220 method Window.CSSMathProduct
 221 method Window.CSSMathSum
 222 method Window.CSSMathValue
 223 method Window.CSSMatrixComponent
 224 method Window.CSSNumericArray
 225 method Window.CSSNumericValue
 226 method Window.CSSPerspective
 227 method Window.CSSPositionValue
 228 method Window.CSSRotate
 229 method Window.CSSScale
 230 method Window.CSSSkew
 231 method Window.CSSSkewX
 232 method Window.CSSSkewY
 233 method Window.CSSStyleValue
 234 method Window.CSSTransformComponent
 235 method Window.CSSTransformValue
 236 method Window.CSSTranslate
 237 method Window.CSSUnitValue
 238 method Window.CSSUnparsedValue
 239 method Window.CSSVariableReferenceValue
 240 method Window.defaultStatus
 241 // See comments in Window.webidl about why this is disabled.
 242 //method Window.defaultstatus
 243 method Window.DeviceMotionEventAcceleration
 244 method Window.DeviceMotionEventRotationRate
 245 method Window.DOMError
 246 method Window.EnterPictureInPictureEvent
 247 method Window.External
 248 method Window.FederatedCredential
 249 method Window.Gyroscope
 250 method Window.HTMLContentElement
 251 method Window.HTMLDialogElement
 252 method Window.HTMLShadowElement
 253 method Window.ImageCapture
 254 method Window.InputDeviceCapabilities
 255 method Window.InputDeviceInfo
 256 method Window.Keyboard
 257 method Window.KeyboardLayoutMap
 258 method Window.LinearAccelerationSensor
 259 method Window.Lock
 260 method Window.LockManager
 261 method Window.MediaMetadata
 262 method Window.MediaSession
 263 method Window.MediaSettingsRange
 264 method Window.MIDIAccess
 265 method Window.MIDIConnectionEvent
 266 method Window.MIDIInput
 267 method Window.MIDIInputMap
 268 method Window.MIDIMessageEvent
 269 method Window.MIDIOutput
 270 method Window.MIDIOutputMap
 271 method Window.MIDIPort
 272 method Window.NavigationPreloadManager
 273 method Window.NetworkInformation
 274 method Window.offscreenBuffering
 275 method Window.OffscreenCanvas
 276 method Window.OffscreenCanvasRenderingContext2D
 277 method Window.onbeforeinstallprompt
 278 method Window.oncancel
 279 method Window.ondeviceorientationabsolute
 280 method Window.onmousewheel
 281 method Window.onsearch
 282 method Window.onselectionchange
 283 method Window.openDatabase
 284 method Window.OrientationSensor
 285 method Window.OverconstrainedError
 286 method Window.PasswordCredential
 287 method Window.PaymentAddress
 288 method Window.PaymentInstruments
 289 method Window.PaymentManager
 290 method Window.PaymentMethodChangeEvent
 291 method Window.PaymentRequest
 292 method Window.PaymentRequestUpdateEvent
 293 method Window.PaymentResponse
 294 method Window.PerformanceEventTiming
 295 method Window.PerformanceLongTaskTiming
 296 method Window.PerformancePaintTiming
 297 method Window.PhotoCapabilities
 298 method Window.PictureInPictureWindow
 299 method Window.Presentation
 300 method Window.PresentationAvailability
 301 method Window.PresentationConnection
 302 method Window.PresentationConnectionAvailableEvent
 303 method Window.PresentationConnectionCloseEvent
 304 method Window.PresentationConnectionList
 305 method Window.PresentationReceiver
 306 method Window.PresentationRequest
 307 method Window.RelativeOrientationSensor
 308 method Window.RemotePlayback
 309 method Window.ReportingObserver
 310 method Window.RTCDtlsTransport
 311 method Window.RTCError
 312 method Window.RTCErrorEvent
 313 method Window.RTCIceTransport
 314 method Window.RTCSctpTransport
 315 method Window.Sensor
 316 method Window.SensorErrorEvent
 317 method Window.SharedArrayBuffer
 318 method Window.styleMedia
 319 method Window.StylePropertyMap
 320 method Window.StylePropertyMapReadOnly
 321 method Window.SVGDiscardElement
 322 method Window.SyncManager
 323 method Window.TaskAttributionTiming
 324 method Window.TextDecoderStream
 325 method Window.TextEncoderStream
 326 method Window.TextEvent
 327 method Window.Touch
 328 method Window.TouchEvent
 329 method Window.TouchList
 330 method Window.TransformStream
 331 method Window.USB
 332 method Window.USBAlternateInterface
 333 method Window.USBConfiguration
 334 method Window.USBConnectionEvent
 335 method Window.USBDevice
 336 method Window.USBEndpoint
 337 method Window.USBInterface
 338 method Window.USBInTransferResult
 339 method Window.USBIsochronousInTransferPacket
 340 method Window.USBIsochronousInTransferResult
 341 method Window.USBIsochronousOutTransferPacket
 342 method Window.USBIsochronousOutTransferResult
 343 method Window.USBOutTransferResult
 344 method Window.UserActivation
 345 method Window.visualViewport
 346 method Window.webkitCancelAnimationFrame
 347 method Window.webkitMediaStream
 348 method Window.WebKitMutationObserver
 349 method Window.webkitRequestAnimationFrame
 350 method Window.webkitRequestFileSystem
 351 method Window.webkitResolveLocalFileSystemURL
 352 method Window.webkitRTCPeerConnection
 353 method Window.webkitSpeechGrammar
 354 method Window.webkitSpeechGrammarList
 355 method Window.webkitSpeechRecognition
 356 method Window.webkitSpeechRecognitionError
 357 method Window.webkitSpeechRecognitionEvent
 358 method Window.webkitStorageInfo
 359 method Window.Worklet
 360 method Window.WritableStream