Where is the JavaScript DOM API documented? [closed]
The DOM is actually a separate thing to JavaScript. The DOM can be accessed from other languages, such as VBScript in IE. And general-purpose programming languages like Java, Python, PHP etc have their own non-browser-based DOM libraries.
The basic DOM operations that work on both HTML and general XML documents can be found in DOM Core; HTML documents get extra methods defined in DOM HTML. These are the latest ‘levels’ of support defined by W3; not all browsers support everything in DOM Level 3 Core. But DOM Level 1 Core is pretty much solid.
Confusingly, DOM HTML has further developed, but not in its own DOM specification. Instead it is part of HTML5. This standardises a lot of extensions that were already widely supported in browsers, like innerHTML, and adds a bunch more stuff that isn't widely implemented yet (and may be changed before the document is standardised).
The DOM is only the document object model: it specifies what you get inside the document object. It doesn't specify other browser features, like the contents of window. The browser object model (BOM) was previously unstandardised; HTML5 is making the first effort to properly document it.
HTML5 also specifies parts of the browser object model (BOM) that were not previously standardised. Stuff like window that isn't directly connected to the document content.
The upshot of all this is that there isn't a single document you can go to that will tell you everything about what methods and properties you have available to you in web scripting. Some day DOM Core plus HTML5 will cover it all, but today HTML5 includes a lot you can't rely on, and isn't exactly the most readable of guides even by the standards of standards documents. So yes, I'm afraid you're going to have to continue to check MDC and MSDN for popular support.
Is 'Image' a global variable, or is it a property of 'window' the global object?
Image is specified by HTML5 to be a member of the window object, which, being the global context, allows you to refer to it as just Image... that's not quite the same thing as being a global variable, but it's close enough for most.
It is a constructor-function that returns a DOM object implementing the HTMLImageElement interface (from DOM Level 1 HTML, extended in HTML5). It was originally introduced in Netscape 3.0 as a mechanism for pre-loading images; plus already-created images could be accessed from document.images to change their src. Today new Image() doesn't do anything different to document.createElement('img').
I also want to read about the 'src' property, since it has non-standard behavior - when this property is assigned to, the image is reloaded.
Well the image won't be reloaded necessarily, but it may cause the load event to be fired on some browsers. Unfortunately this isn't standardised (even in HTML5 as far as I can see). IE, Firefox and Opera fire load on every src set (even if the src is not changed) whereas WebKit (Chrome/Safari) only ever fires it on the initial image load.
This sort of thing is why there are sites with big tables of differing browser behaviours, and why we still have to actively test on different browsers.
New fave: http://devdocs.io/dom/(Devdocs.io in general is pretty awesome for lots of reference material)
(older) I really like this DOM reference: http://krook.org/jsdom/
For newbies, this will really help with understanding what you are working with and separating the concepts of:
Javascript (a language used to access the DOM, other scripting languages can be used),
an HTML or XML document (the markup that forms the basis of a web page)
and the DOM (a model of the document that serves as an API allowing you to manipulate the structure and contents of the document).
It also links to these informative documents:
W3C: What is the Document Object Model?
MDN: Introduction - Document Object Model
Wikipedia: Document Object Model
Knowing how the DOM developed in a historical context also helps in understanding its structure and how to work with it and this is also covered in the above links.