Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
The HTMLCanvasElement.mozGetAsFile() method returns a File object representing the image contained in the canvas; this file is a memory-based file, with the specified name. If type is not specified, the image type is image/png.
Syntax
canvas.mozGetAsFile(name, type);
Parameters
name- A
DOMStringindicating the file name. typeOptional- A
DOMStringindicating the image format. The default type isimage/png.
Return value
A File object representing the image contained in the canvas.
Examples
Example: Using mozGetAsFile()
HTML snippet:
<canvas id="canvas" width="100" height="100"></canvas> <p><a href="#" id="link">Click here to try out mozGetAsFile().</a></p>
The following code uses mozGetAsFile to create a File object from the canvas and appends it as an image to the page using FileReader.readAsDataURL():
function draw() {
var canvas = document.getElementById('canvas');
var ctx = canvas.getContext('2d');
ctx.fillStyle = 'rgb(200, 0, 0)';
ctx.fillRect(10, 10, 55, 50);
ctx.fillStyle = 'rgba(0, 0, 200, 0.5)';
ctx.fillRect(30, 30, 55, 50);
var link = document.getElementById('link');
link.addEventListener('click', copy);
}
function copy() {
var canvas = document.getElementById('canvas');
var f = canvas.mozGetAsFile('test.png');
var reader = new FileReader();
reader.readAsDataURL(f);
reader.onloadend = function() {
var newImg = document.createElement('img');
newImg.src = reader.result;
document.body.appendChild(newImg);
}
}
window.addEventListener('load', draw);
Specifications
Not part of any specification.
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | No support | 4.0 (2) | No support | No support | No support |
| Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | No support | No support | 4.0 (2) | No support | No support | No support |
See also
- The interface defining it,
HTMLCanvasElement.