警告 : Removed in Firefox 65.

getScreenshot() 方法在 HTMLIFrameElement lets you request a screenshot of a content <iframe> , scaled to fit within a specified maximum width and height. The image will be cropped if necessary but will not be distorted vertically or horizontally.

注意 : getScreenshot() waits for the event loop to go idle before it takes the screenshot. It won't wait more than 2000ms (this delay is defined by the Gecko dom.browserElement.maxScreenshotDelayMS preference).

句法

var instanceOfDOMRequest =
instanceOfHTMLIframeElement.getScreenshot(maxWidth, maxHeight, mimeType);
					

返回

A DOMRequest for handling the screenshot request. Its request.onsuccess handler handles the success case (the screenshot is contained in request.result 作为 Blob object), and its request.onerror handler handles the failure case.

参数

maxWidth

A number representing the maximum width of the screenshot in device pixels.

maxHeight

A number representing the maximum height of the screenshot in device pixels.

mimeType 可选
A MIME type specifying the format of the image to be returned; if not specified, the default used is image/jpeg 。使用 image/png to capture the alpha channel of the rendered result by returning a PNG-format image. This lets you get a transparent background for the content <iframe> .

范例

var browser = document.querySelector('iframe');
var request = browser.getScreenshot(100, 100);
request.onsuccess = function() {
  var blob = request.result;
  var url = URL.createObjectURL(blob);
}
					

规范

Not part of any specification.

浏览器兼容性

Supported since Firefox 47, in chrome code only. Removed completely in Firefox 65.

Unlikely ever to be supported in other browsers.

另请参阅

元数据

  • 最后修改:
  1. 方法
    1. HTMLIFrameElement.addNextPaintListener()
    2. HTMLIFrameElement.clearMatch()
    3. HTMLIFrameElement.download()
    4. HTMLIFrameElement.executeScript()
    5. HTMLIFrameElement.findAll()
    6. HTMLIFrameElement.findNext()
    7. HTMLIFrameElement.getActive()
    8. HTMLIFrameElement.getCanGoBack()
    9. HTMLIFrameElement.getCanGoForward()
    10. HTMLIFrameElement.getContentDimensions()
    11. HTMLIFrameElement.getMainfest()
    12. HTMLIFrameElement.getMuted()
    13. HTMLIFrameElement.getScreenshot()
    14. HTMLIFrameElement.getStructuredData()
    15. HTMLIFrameElement.goBack()
    16. HTMLIFrameElement.goForward()
    17. HTMLIFrameElement.getVisible()
    18. HTMLIFrameElement.getVolume()
    19. HTMLIFrameElement.mute()
    20. HTMLIFrameElement.purgeHistory()
    21. HTMLIFrameElement.reload()
    22. HTMLIFrameElement.removeNextPaintListener()
    23. HTMLIFrameElement.sendMouseEvent()
    24. HTMLIFrameElement.sendTouchEvent()
    25. HTMLIFrameElement.setActive()
    26. HTMLIFrameElement.setInputMethodActive()
    27. HTMLIFrameElement.setNFCFocus()
    28. HTMLIFrameElement.setVisible()
    29. HTMLIFrameElement.setVolume()
    30. HTMLIFrameElement.stop()
    31. HTMLIFrameElement.unmute()
    32. HTMLIFrameElement.zoom()
  2. 事件
    1. mozbrowseractivitydone
    2. mozbrowserasyncscroll
    3. mozbrowseraudioplaybackchange
    4. mozbrowsercaretstatechanged
    5. mozbrowserclose
    6. mozbrowsercontextmenu
    7. mozbrowserdocumentfirstpaint
    8. mozbrowsererror
    9. mozbrowserfindchange
    10. mozbrowserfirstpaint
    11. mozbrowsericonchange
    12. mozbrowserloadend
    13. mozbrowserloadstart
    14. mozbrowserlocationchange
    15. mozbrowsermanifestchange
    16. mozbrowsermetachange
    17. mozbrowseropensearch
    18. mozbrowseropentab
    19. mozbrowseropenwindow
    20. mozbrowserresize
    21. mozbrowserscroll
    22. mozbrowserscrollareachanged
    23. mozbrowserscrollviewchange
    24. mozbrowsersecuritychange
    25. mozbrowserselectionstatechanged
    26. mozbrowsershowmodalprompt
    27. mozbrowsertitlechange
    28. mozbrowserusernameandpasswordrequired
    29. mozbrowservisibilitychange