Web/API/HTMLObjectElement

The HTMLObjectElement interface provides special properties and methods (beyond those on the HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of <object> element, representing external resources.

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25  236,20  236,30  226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25  351,20  351,30  341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25  501,20  501,30  491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLObjectElement" target="_top"><rect x="321" y="65" width="170" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="406" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLObjectElement</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

Properties

Inherits properties from its parent, HTMLElement.

HTMLObjectElement.align '

Is a DOMString representing an enumerated property indicating alignment of the element's contents with respect to the surrounding context. The possible values are "left", "right", "justify", and "center".

HTMLObjectElement.archive '

Is a DOMString that reflects the archive HTML attribute, containing a list of archives for resources for this object.

HTMLObjectElement.border '

Is a DOMString that reflects the border HTML attribute, specifying the width of a border around the object.

HTMLObjectElement.code '

Is a DOMString representing the name of an applet class file, containing either the applet's subclass, or the path to get to the class, including the class file itself.

HTMLObjectElement.codeBase '

Is a DOMString that reflects the codebase HTML attribute, specifying the base path to use to resolve relative URIs.

HTMLObjectElement.codeType '

Is a DOMString that reflects the codetype HTML attribute, specifying the content type of the data.

HTMLObjectElement.contentDocument Read only

Returns a Document representing the active document of the object element's nested browsing context, if any; otherwise null.

HTMLObjectElement.contentWindow Read only

Returns a WindowProxy representing the window proxy of the object element's nested browsing context, if any; otherwise null.

HTMLObjectElement.data

Returns a DOMString that reflects the data HTML attribute, specifying the address of a resource's data.

HTMLObjectElement.declare '

Is a Boolean that reflects the declare HTML attribute, indicating that this is a declaration, not an instantiation, of the object.

HTMLObjectElement.form Read only

Retuns a HTMLFormElement representing the object element's form owner, or null if there isn't one.

HTMLObjectElement.height

Returns a DOMString that reflects the height HTML attribute, specifying the displayed height of the resource in CSS pixels.

HTMLObjectElement.hspace '

Is a long representing the horizontal space in pixels around the control.

HTMLObjectElement.name

Returns a DOMString that reflects the name HTML attribute, specifying the name of the browsing context.

HTMLObjectElement.standby '

Is a DOMString that reflects the standby HTML attribute, specifying a message to display while the object loads.

HTMLObjectElement.tabindex

Is a long representing the position of the element in the tabbing navigation order for the current document.

HTMLObjectElement.type

Is a DOMString that reflects the type HTML attribute, specifying the MIME type of the resource.

HTMLObjectElement.typeMustMatch

Is a Boolean that reflects the typemustmatch HTML attribute, indicating if the resource specified by data must only be played if it matches the type attribute.

HTMLObjectElement.useMap

Is a DOMString that reflects the usemap HTML attribute, specifying a <map> element to use.

HTMLObjectElement.validationMessage Read only

Returns a DOMString representing a localized message that describes the validation constraints that the control does not satisfy (if any). This is the empty string if the control is not a candidate for constraint validation (willValidate is false), or it satisfies its constraints.

HTMLObjectElement.validity Read only

Returns a ValidityState with the validity states that this element is in.

HTMLObjectElement.vspace '

Is a long representing the horizontal space in pixels around the control.

HTMLObjectElement.width

Is a DOMString that reflects the width HTML attribute, specifying the displayed width of the resource in CSS pixels.

HTMLObjectElement.willValidate Read only

Returns a Boolean that indicates whether the element is a candidate for constraint validation. Always false for HTMLObjectElement objects.

Methods

Inherits methods from its parent, HTMLElement.

HTMLObjectElement.checkValidity()

Retuns a Boolean that always is true, because object objects are never candidates for constraint validation.

HTMLObjectElement.setCustomValidity()

Sets a custom validity message for the element. If this message is not the empty string, then the element is suffering from a custom validity error, and does not validate.

Specifications

Specification	Status	Comment
HTML Living StandardThe definition of 'HTMLObjectElement' in that specification.	Living Standard
HTML5The definition of 'HTMLObjectElement' in that specification.	Recommendation	The W3C specification is a latest of a previous version of HTML Living Standard Technically, the property tabindex is now defined on HTMLElement. The following properties are now obsolete: align, archive, border, code, codeBase, codeType, declare, hspace, standby, and vspace. The following properties have been added: typeMustMatch, contentWindow, willValidate, validity, and validationMessage. The following methods have been added: checkValidity() and setCustomValidity().
Document Object Model (DOM) Level 2 HTML SpecificationThe definition of 'HTMLObjectElement' in that specification.	Obsolete	The contentDocument property has been added.
Document Object Model (DOM) Level 1 SpecificationThe definition of 'HTMLObjectElement' in that specification.	Obsolete	Initial definition.

Browser compatibility

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
HTMLObjectElement	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support Yes	WebView Android Full support 37	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
align Deprecated'	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 37	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
archive Deprecated'	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 37	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
border Deprecated'	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 37	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
checkValidity	Chrome Full support 46	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 46	Chrome Android Full support 46	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 5.0
code Deprecated'	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 37	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
codeBase Deprecated'	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 37	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
codeType Deprecated'	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 37	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
contentDocument	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support 40	Safari Full support 10	WebView Android Full support 37	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support 41	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
contentWindow	Chrome Full support 53	Edge Full support 17	Firefox Full support Yes	IE No support No	Opera No support No	Safari No support No	WebView Android Full support 53	Chrome Android Full support 53	Firefox Android No support No	Opera Android No support No	Safari iOS No support No	Samsung Internet Android Full support 6.0
data	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 37	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
declare Deprecated'	Chrome Full support 46	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 46	Chrome Android Full support 46	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 5.0
form	Chrome Full support 46	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 46	Chrome Android Full support 46	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 5.0
getSVGDocument	Chrome Full support Yes	Edge Full support 12	Firefox Full support Yes	IE No support No	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
height	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 37	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
hspace Deprecated'	Chrome Full support 46	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 46	Chrome Android Full support 46	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 5.0
name	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 37	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
reportValidity	Chrome Full support Yes	Edge Full support 18	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 10	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
setCustomValidity	Chrome Full support Yes	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
standby Deprecated'	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 37	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
type	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 37	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
typeMustMatch	Chrome No support No	Edge No support No	Firefox Full support 27	IE No support No	Opera No support No	Safari No support No	WebView Android No support No	Chrome Android No support No	Firefox Android Full support 27	Opera Android No support No	Safari iOS No support No	Samsung Internet Android No support No
useMap	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 37	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
validationMessage	Chrome Full support 46	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 46	Chrome Android Full support 46	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 5.0
validity	Chrome Full support 46	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 46	Chrome Android Full support 46	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 5.0
vspace Deprecated'	Chrome Full support 46	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 46	Chrome Android Full support 46	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 5.0
width	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 37	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
willValidate	Chrome Full support 46	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support 6	WebView Android Full support 46	Chrome Android Full support 46	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 5.0

Legend

Full support  

Full support

No support  

No support

Deprecated. Not for use in new websites.'

Deprecated. Not for use in new websites.

See also

• The HTML element implementing this interface: <object>

HTMLObjectElement by Mozilla Contributors is licensed under CC-BY-SA 2.5.