Cliente GrabzIt con Node.js
Descripción
Esta clase maneja toda la comunicación con los servicios web de captura de pantalla de GrabzIt.
Métodos públicos
- get_result(id)
- url_to_animation(url, options)
- url_to_image(url, options)
- html_to_image(html, options)
- file_to_image(path, options)
- url_to_pdf(url, options)
- html_to_pdf(html, options)
- file_to_pdf(path, options)
- url_to_docx(url, options)
- html_to_docx(html, options)
- file_to_docx(path, options)
- url_to_table(url, options)
- html_to_table(html, options)
- file_to_table(path, options)
- url_to_rendered_html(url, options)
- html_to_rendered_html(html, options)
- file_to_rendered_html(path, options)
- save(callBackUrl, oncomplete)
- save_to(saveToFile, oncomplete)
- get_status(id, oncomplete)
- get_cookies(domain, oncomplete)
- set_cookie(name, domain, options, oncomplete)
- delete_cookie(name, domain, oncomplete)
- get_watermarks(oncomplete)
- get_watermark(identifier, oncomplete)
- add_watermark(identifier, path, xpos, ypos, oncomplete)
- delete_watermark(identifier, oncomplete)
- set_local_proxy(value)
- use_ssl(value)
- create_encryption_key()
- decrypt(data, key)
- decrypt_file(path, key, oncomplete)
get_result (id)
Este método devuelve la captura de pantalla en sí. Si no se devuelve nada, entonces algo salió mal o la captura de pantalla aún no está lista.
parámetros
-
id: el identificador único de la captura de pantalla
url_to_animation(url, opciones)
Especifique la URL del video en línea que debe convertirse into un GIF animado.
parámetros
-
url: la URL del video en línea para convertir into un GIF animado
- Requerido
-
Acepta URL de videos de Vimeo y YouTube
- La advertencia de animación de videos de Vimeo y YouTube depende de un tercero y, por lo tanto, puede no proporcionar resultados consistentes.
- opciones - un objeto JSON que define las opciones especiales para usar al crear el GIF animado.
Valor de retorno
vacío
Opciones de animacion
Todas las opciones disponibles al crear un GIF animado.
-
customId - Identificador personalizado que puede pasar al servicio web animado GIF. Esto se devolverá con la URL de devolución de llamada que ha especificado.
-
width - el ancho del GIF animado resultante en píxeles.
- Predeterminado: 180px
- Máximo: ancho máximo para el paquete
- Tamaño automático: -1 (pasando -1 significa que el ancho de la GIF animado se escala en relación con su altura, si el ancho se ajusta automáticamente, la altura no puede)
-
height - la altura del GIF animado resultante en píxeles.
- Predeterminado: 120px
- Máximo: altura máxima para el paquete
- Tamaño automático: -1 (pasando -1 significa que la altura de la GIF animado se escala en relación con su ancho, si la altura se está dimensionando automáticamente, el ancho no puede)
-
start - la posición inicial del video que debe convertirse into un GIF animado.
- Predeterminado: 0 segundos
-
duration - la duración en segundos del video que debe convertirse into un GIF animado.
- Valor predeterminado: longitud máxima para el paquete
-
speed - La velocidad del GIF animado.
- Predeterminado: 1
- Mínimo: 0.2
- Máxima: 10
-
framesPerSecond - la cantidad de fotogramas por segundo que deben capturarse del video.
- Predeterminado: 10
- Mínimo: 0.2
- Máxima: 60
-
repeat - Número de veces para recorrer el GIF animado.
- Predeterminado: 0
- Bucle continuo: 0
- Nunca bucle: -1
-
reverse - si es cierto, los cuadros del GIF animado se invierten
-
customWaterMarkId - Agrega un personalizado watermark or especial watermark al GIF animado
-
quality - el calidad de la imagen devuelta, que tiene una compresión predeterminada de 85%.
- Reducir la calidad reducirá el tamaño del archivo y reducirá los tiempos de descarga.
- Predeterminado: -1
- Mínimo: -1
- Máxima: 100
-
country - el país el GIF animado debe tomarse de.
- Valor predeterminado: la ubicación más rápida actual
- Opciones: "SG", "Reino Unido", "EE. UU."
-
exportUrl - el exportar URL que especifica dónde se debe exportar la captura también
-
encryptionKey - si se especifica una clave de cifrado AES codificada con 64 base, su captura se cifra cuando se crea. Se recomienda usar el crear método de clave de cifrado para crear la clave y el descifrar métodos para descifrar la captura cifrada como se muestra en este ejemplo.
-
proxy - los detalles del proxy HTTP el software del navegador debe usar para crear esta captura
Ejemplo de opciones
{
'width':250,
'height':250,
'speed':2
}
url_to_image(url, opciones)
Especifica la URL que se debe convertir into una captura de pantalla de imagen.
parámetros
-
url: la URL de la que debe estar hecha la captura de pantalla
- opciones - un objeto JSON que define las opciones especiales para usar al crear la captura de pantalla.
Valor de retorno
vacío
html_to_image(html, opciones)
Especifica el HTML que se debe convertir intuna imagen
parámetros
Valor de retorno
vacío
file_to_image(camino, opciones)
Especifica un archivo HTML que debe convertirse intuna imagen
parámetros
-
ruta de acceso: la ruta del archivo HTML para convertir intuna imagen
- opciones - un objeto JSON que define cualquier opción especial para usar al crear una imagen.
Valor de retorno
vacío
Opciones de imagen
Todas las opciones disponibles al crear capturas de imágenes.
-
customId - Identificador personalizado que puede pasar al servicio web de captura de pantalla. Esto se devolverá con la URL de devolución de llamada que ha especificado.
-
browserWidth - el ancho del navegador en píxeles
- Predeterminado: 1366
- Máxima: 10000
-
browserHeight - la altura del navegador en píxeles
- Predeterminado: 1170
- Máxima: 10000
- Longitud total: -1 (pasar -1 significa que se toma una captura de pantalla de toda la página web)
-
width - el ancho de la miniatura resultante en píxeles
- Predeterminado: si no se especifican el ancho y la altura de salida o 0, el ancho y la altura de salida coincidirán con el ancho y alto de la imagen final, si se especifica la altura de salida, el ancho de salida será proporcional a la altura de salida
- Máximo: ancho máximo para el paquete
- Ancho completo: -1 (pasar -1 significa que el ancho de la miniatura no se reduce)
-
height - la altura de la miniatura resultante en mm
- Predeterminado: si no se especifica el ancho y la altura de salida o 0, entonces el ancho y alto de salida coincidirán con el ancho y alto de la imagen final, si se especifica el ancho de salida, la altura de salida será proporcional al ancho de salida
- Máximo: altura máxima para el paquete
- Altura completa: -1 (pasar -1 significa que la altura de la miniatura no se reduce)
-
format - el formato en el que debe estar la captura de pantalla.
- Predeterminado: "jpg"
- Opciones: "bmp8", "bmp16", "bmp24", "bmp", "tiff", "webp", "jpg", "png"
-
delay - el número de milisegundos a espera antes de tomar la captura de pantalla
- Predeterminado: 0
- Máxima: 30000
-
clickElement - esto especifica el elemento HTML, usando un Selector de CSS hacer click. Recuerde que también puede ser necesario un retraso para ver los efectos del clic.
- Advertencia: esta característica está actualmente en versión beta y puede no proporcionar resultados consistentes.
-
targetElement - el Selector de CSS del único elemento HTML en la página web de destino que se va a convertir into una captura de pantalla, se ignoran todas las otras partes de la página web. Si hay varios elementos HTML coincidentes, se elige el primero.
-
hideElement - el Selectores CSS de uno o más elementos HTML en la página web para ocultar, para especificar múltiples elementos HTML para ocultar, separe cada selector con una coma
-
waitForElement - el Selectores CSS del elemento HTML en la página web que debe ser visible antes de realizar la captura
-
requestAs - el tipo de agente de usuario que desea utilizar
- Predeterminado: 0
-
Opciones:
- 0 = indica que se debe usar el agente de usuario de un navegador estándar
- 1 = indica que se debe usar el agente de usuario de un navegador móvil
- 2 = indica que se debe usar el agente de usuario de un motor de búsqueda
-
customWaterMarkId - Agrega un personalizado watermark or especial watermark a la imagen
-
quality - el calidad de la imagen devuelta. Actualmente, esto solo afecta a las imágenes JPG y WEBP, que tienen una compresión predeterminada del 90%.
- Reducir la calidad reducirá el tamaño del archivo y reducirá los tiempos de descarga.
- Predeterminado: -1
- Mínimo: -1
- Máxima: 100
-
transparent - si es cierto el la captura de imagen debe ser transparente. Esto solo es compatible con imágenes png y tiff.
-
hd - si es verdad la imagen la captura será en alta definición esto duplica el tamaño de las dimensiones de la imagen.
-
country - el país la captura de pantalla debe tomarse de.
- Valor predeterminado: la ubicación más rápida actual
- Opciones: "SG", "Reino Unido", "EE. UU."
-
exportUrl - el exportar URL que especifica dónde se debe exportar la captura también
-
encryptionKey - si se especifica una clave de cifrado AES codificada con 64 base, su captura se cifra cuando se crea. Se recomienda usar el crear método de clave de cifrado para crear la clave y el descifrar métodos para descifrar la captura cifrada como se muestra en este ejemplo.
-
noAds - si es verdad los anuncios deben ocultarse automáticamente.
-
noCookieNotifications - si es cierto, todos se encuentran comúnmente las notificaciones de cookies deben ocultarse automáticamente.
-
address - la URL para ejecutar el código HTML. Puede ser útil si el HTML que se está convirtiendo usa URL relativas para recursos como CSS e imágenes.
-
post - define la consulta HTTP Poststring. Cada nombre y valor en la consultastring deberá estar codificado en URL. El uso de esta opción obligará a GrabzIt a realizar una publicación HTTP.
-
proxy - los detalles del proxy HTTP el software del navegador debe usar para crear esta captura
Ejemplo de opciones
{
'width':500,
'height':500
}
url_to_rendered_html(url, opciones)
Especifica la URL que se debe convertir into HTML procesado.
parámetros
-
url: la URL de la que debe estar hecho el HTML representado
- opciones - un objeto JSON que define las opciones especiales para usar al crear el HTML representado.
Valor de retorno
vacío
html_to_rendered_html(html, opciones)
Especifica el HTML que se debe convertir into HTML procesado.
parámetros
Valor de retorno
vacío
file_to_rendered_html(camino, opciones)
Especifica un archivo HTML que debe convertirse into HTML procesado.
parámetros
-
ruta de acceso: la ruta del archivo HTML para convertir into HTML procesado
- opciones - un objeto JSON que define cualquier opción especial para usar al crear HTML renderizado.
Valor de retorno
vacío
Opciones HTML
Todas las opciones disponibles cuando crear capturas HTML representadas.
-
customId - Identificador personalizado que puede pasar al servicio web. Esto se devolverá con la URL de devolución de llamada que ha especificado.
-
browserWidth - el ancho del navegador en píxeles
- Predeterminado: 1366
- Máxima: 10000
-
browserHeight - la altura del navegador en píxeles
- Predeterminado: 1170
- Máxima: 10000
-
delay - el número de milisegundos a espera antes de tomar la captura de pantalla
- Predeterminado: 0
- Máxima: 30000
-
clickElement - esto especifica el elemento HTML, usando un Selector de CSS hacer click. Recuerde que también puede ser necesario un retraso para ver los efectos del clic.
- Advertencia: esta característica está actualmente en versión beta y puede no proporcionar resultados consistentes.
-
waitForElement - el Selectores CSS del elemento HTML en la página web que debe ser visible antes de realizar la captura
-
requestAs - el tipo de agente de usuario que desea utilizar
- Predeterminado: 0
-
Opciones:
- 0 = indica que se debe usar el agente de usuario de un navegador estándar
- 1 = indica que se debe usar el agente de usuario de un navegador móvil
- 2 = indica que se debe usar el agente de usuario de un motor de búsqueda
-
country - el país la captura de pantalla debe tomarse de.
- Valor predeterminado: la ubicación más rápida actual
- Opciones: "SG", "Reino Unido", "EE. UU."
-
exportUrl - el exportar URL que especifica dónde se debe exportar la captura también
-
encryptionKey - si se especifica una clave de cifrado AES codificada con 64 base, su captura se cifra cuando se crea. Se recomienda usar el crear método de clave de cifrado para crear la clave y el descifrar métodos para descifrar la captura cifrada como se muestra en este ejemplo.
-
noAds - si es verdad los anuncios deben ocultarse automáticamente.
-
noCookieNotifications - si es cierto, todos se encuentran comúnmente las notificaciones de cookies deben ocultarse automáticamente.
-
address - la URL para ejecutar el código HTML. Puede ser útil si el HTML que se está convirtiendo usa URL relativas para recursos como CSS e imágenes.
-
post - define la consulta HTTP Poststring. Cada nombre y valor en la consultastring deberá estar codificado en URL. El uso de esta opción obligará a GrabzIt a realizar una publicación HTTP.
-
proxy - los detalles del proxy HTTP el software del navegador debe usar para crear esta captura
Ejemplo de opciones
{
'country':'SG',
'delay':5000
}
url_to_pdf(url, opciones)
Especifica la URL que se debe convertir intoa PDF.
parámetros
-
url: la URL a la que se debe convertir intoa PDF
- opciones - un objeto JSON que define las opciones especiales para usar al crear un PDF.
Valor de retorno
vacío
html_to_pdf(html, opciones)
Especifica el HTML que se debe convertir intoa PDF.
parámetros
Valor de retorno
vacío
file_to_pdf(camino, opciones)
Especifica un archivo HTML que debe convertirse intoa PDF.
parámetros
-
ruta de acceso: la ruta del archivo HTML para convertir intoa PDF
- opciones - un objeto JSON que define las opciones especiales para usar al crear un PDF.
Valor de retorno
vacío
Opciones de PDF
Todas las opciones disponibles al crear capturas de PDF.
-
customId - un identificador personalizado que puede pasar al servicio web. Esto se devolverá con la URL de devolución de llamada que ha especificado.
-
includeBackground - si es cierto, el fondo de la página web debe incluirse en la captura de pantalla
- Predeterminado: verdadero
-
pagesize - el tamaño de página del PDF
- Valor predeterminado: "A4"
- Opciones: "A3", "A4", "A5", "A6", "B3", "B4", "B5", "B6", "Legal", "Carta"
-
orientation - la orientación del documento PDF
- Valor predeterminado: "Retrato"
- Opciones: "Retrato", "Paisaje"
-
cssMediaType - el Tipo de medio CSS del documento PDF
- Pantalla predeterminada"
- Opciones: "Pantalla", "Print"
-
includeLinks - verdadero si los enlaces deben incluirse en el PDF
- Predeterminado: verdadero
-
includeOutline - cierto si Marcadores PDF debe ser incluido
-
title - proporcione un título para el documento PDF
-
coverUrl - la URL de una página web que debe usarse como portada del PDF
-
marginTop - el margen en milímetros que debería aparecer en la parte superior de la página del documento PDF
-
marginLeft - el margen en milímetros que debería aparecer a la izquierda de la página del documento PDF
-
marginBottom - el margen en milímetros que debería aparecer en la parte inferior de la página del documento PDF
-
marginRight - el margen en milímetros que debería aparecer a la derecha del documento PDF
-
browserWidth - el ancho del navegador en píxeles
- Advertencia: esta característica está actualmente en versión beta y puede no proporcionar resultados consistentes.
- Predeterminado: 1366
- Máxima: 10000
- Ancho automático: -1 (pasar -1 significa que el ancho del navegador coincide con el ancho del documento PDF)
-
pageWidth - el ancho personalizado del PDF resultante en mm
-
pageHeight - el altura personalizada del PDF resultante en mm
-
delay - el número de milisegundos a espera antes de tomar la captura de pantalla
- Predeterminado: 0
- Máxima: 30000
-
requestAs - el tipo de agente de usuario que desea utilizar
- Predeterminado: 0
-
Opciones:
- 0 = indica que se debe usar el agente de usuario de un navegador estándar
- 1 = indica que se debe usar el agente de usuario de un navegador móvil
- 2 = indica que se debe usar el agente de usuario de un motor de búsqueda
-
templateId - Agrega un plantilla ID que especifica el encabezado y pie de página del documento PDF
-
clickElement - esto especifica el elemento HTML, usando un Selector de CSS hacer click. Recuerde que también puede ser necesario un retraso para ver los efectos del clic.
- Advertencia: esta característica está actualmente en versión beta y puede no proporcionar resultados consistentes.
-
targetElement - el Selector de CSS de los únicos Elemento HTML en la página web de destino que se va a convertir intoa PDF, todas las demás partes de la página web se ignoran. Si hay varios elementos HTML coincidentes, se elige el primero.
-
hideElement - el Selectores CSS de uno o más elementos HTML en la página web para ocultar, para especificar múltiples elementos HTML para ocultar, separe cada selector con una coma
-
waitForElement - el Selectores CSS del elemento HTML en la página web que debe ser visible antes de realizar la captura
-
customWaterMarkId - Agrega un personalizado watermark or especial watermark a cada página del documento PDF
-
quality - el calidad del PDF devuelto. El valor predeterminado utiliza la calidad recomendada para el PDF.
- Reducir la calidad reducirá el tamaño del archivo y reducirá los tiempos de descarga.
- Predeterminado: -1
- Mínimo: -1
- Máxima: 100
-
country - el país la captura de pantalla debe tomarse de.
- Valor predeterminado: la ubicación más rápida actual
- Opciones: "SG", "Reino Unido", "EE. UU."
-
exportUrl - el exportar URL que especifica dónde se debe exportar la captura también
-
encryptionKey - si se especifica una clave de cifrado AES codificada con 64 base, su captura se cifra cuando se crea. Se recomienda usar el crear método de clave de cifrado para crear la clave y el descifrar métodos para descifrar la captura cifrada como se muestra en este ejemplo.
-
noAds - si es verdad los anuncios deben ocultarse automáticamente.
-
noCookieNotifications - si es cierto, todos se encuentran comúnmente las notificaciones de cookies deben ocultarse automáticamente.
-
address - la URL para ejecutar el código HTML. Puede ser útil si el HTML que se está convirtiendo usa URL relativas para recursos como CSS e imágenes.
-
post - define la consulta HTTP Poststring. Cada nombre y valor en la consultastring deberá estar codificado en URL. El uso de esta opción obligará a GrabzIt a realizar una publicación HTTP.
-
templateVariables - define un plantilla personalizada parámetro y valor como una consultastring. Cada nombre y valor en la consultastring deberá estar codificado en URL.
-
proxy - los detalles del proxy HTTP el software del navegador debe usar para crear esta captura
-
mergeId - la identificación de una captura que debería ser fusionado al comienzo del nuevo documento PDF
-
password - el contraseña para proteger el documento PDF
Ejemplo de opciones
{
'pagesize':'A5',
'includeLinks':true
}
url_to_docx(url, opciones)
Especifica la URL que se debe convertir into DOCX.
parámetros
-
url: la URL a la que se debe convertir intoa DOCX
- opciones - un objeto JSON que define las opciones especiales para usar al crear un DOCX.
Valor de retorno
vacío
html_to_docx(html, opciones)
Especifica el HTML que se debe convertir into DOCX.
parámetros
Valor de retorno
vacío
file_to_docx(camino, opciones)
Especifica un archivo HTML que debe convertirse into DOCX.
parámetros
-
ruta de acceso: la ruta del archivo HTML para convertir intoa DOCX
- opciones - un objeto JSON que define las opciones especiales para usar al crear un DOCX.
Valor de retorno
vacío
Opciones de DOCX
Todas las opciones disponibles al crear capturas DOCX.
-
customId - un identificador personalizado que puede pasar al servicio web. Esto se devolverá con la URL de devolución de llamada que ha especificado.
-
includeBackground - si es cierto, las imágenes de fondo de la página web deben incluirse en el DOCX
- Predeterminado: verdadero
-
pagesize - el tamaño de página del DOCX
- Valor predeterminado: "A4"
- Opciones: "A3", "A4", "A5", "A6", "B3", "B4", "B5", "B6", "Legal", "Carta"
-
orientation - la orientación del documento DOCX
- Valor predeterminado: "Retrato"
- Opciones: "Retrato", "Paisaje"
-
includeLinks - verdadero si los enlaces deben incluirse en el DOCX
- Predeterminado: verdadero
-
includeImages - si es cierto, las imágenes de la página web deben incluirse en el DOCX
- Predeterminado: verdadero
-
title - proporcione un título para el documento DOCX
-
marginTop - el margen en milímetros que debería aparecer en la parte superior de la página del documento DOCX
-
marginLeft - el margen en milímetros que debería aparecer a la izquierda de la página del documento DOCX
-
marginBottom - el margen en milímetros que debería aparecer en la parte inferior de la página del documento DOCX
-
marginRight - el margen en milímetros que debería aparecer a la derecha del documento DOCX
-
browserWidth - el ancho del navegador en píxeles
- Advertencia: esta característica está actualmente en versión beta y puede no proporcionar resultados consistentes.
- Predeterminado: 1366
- Máxima: 10000
- Ancho automático: -1 (pasar -1 significa que el ancho del navegador coincide con el ancho del documento DOCX)
-
pageWidth - el ancho personalizado del DOCX resultante en mm
-
pageHeight - el altura personalizada del DOCX resultante en mm
-
delay - el número de milisegundos a espera antes de tomar la captura de pantalla
- Predeterminado: 0
- Máxima: 30000
-
requestAs - el tipo de agente de usuario que desea utilizar
- Predeterminado: 0
-
Opciones:
- 0 = indica que se debe usar el agente de usuario de un navegador estándar
- 1 = indica que se debe usar el agente de usuario de un navegador móvil
- 2 = indica que se debe usar el agente de usuario de un motor de búsqueda
-
templateId - Agrega un plantilla ID que especifica el encabezado y pie de página del documento DOCX
-
clickElement - esto especifica el elemento HTML, usando un Selector de CSS hacer click. Recuerde que también puede ser necesario un retraso para ver los efectos del clic.
- Advertencia: esta característica está actualmente en versión beta y puede no proporcionar resultados consistentes.
-
targetElement - el Selector de CSS del único elemento HTML en la página web de destino que se va a convertir into DOCX, todas las otras partes de la página web son ignoradas. Si hay varios elementos HTML coincidentes, se elige el primero.
-
hideElement - el Selectores CSS de uno o más elementos HTML en la página web para ocultar, para especificar múltiples elementos HTML para ocultar, separe cada selector con una coma
-
waitForElement - el Selectores CSS del elemento HTML en la página web que debe ser visible antes de realizar la captura
-
quality - el calidad del DOCX devuelto. La calidad predeterminada de las imágenes en el DOCX es 85%.
- Reducir la calidad reducirá el tamaño del archivo y reducirá los tiempos de descarga.
- Predeterminado: -1
- Mínimo: -1
- Máxima: 100
-
country - el país la captura de pantalla debe tomarse de.
- Valor predeterminado: la ubicación más rápida actual
- Opciones: "SG", "Reino Unido", "EE. UU."
-
exportUrl - el exportar URL que especifica dónde se debe exportar la captura también
-
encryptionKey - si se especifica una clave de cifrado AES codificada con 64 base, su captura se cifra cuando se crea. Se recomienda usar el crear método de clave de cifrado para crear la clave y el descifrar métodos para descifrar la captura cifrada como se muestra en este ejemplo.
-
noAds - si es verdad los anuncios deben ocultarse automáticamente.
-
noCookieNotifications - si es cierto, todos se encuentran comúnmente las notificaciones de cookies deben ocultarse automáticamente.
-
address - la URL para ejecutar el código HTML. Puede ser útil si el HTML que se está convirtiendo usa URL relativas para recursos como CSS e imágenes.
-
post - define la consulta HTTP Poststring. Cada nombre y valor en la consultastring deberá estar codificado en URL. El uso de esta opción obligará a GrabzIt a realizar una publicación HTTP.
-
templateVariables - define un plantilla personalizada parámetro y valor como una consultastring. Cada nombre y valor en la consultastring deberá estar codificado en URL.
-
proxy - los detalles del proxy HTTP el software del navegador debe usar para crear esta captura
-
mergeId - la identificación de una captura que debería ser fusionado al comienzo del nuevo documento DOCX
-
password - el contraseña para proteger el documento DOCX
Ejemplo de opciones
{
'pagesize':'A5',
'includeLinks':true
}
url_to_table(url, opciones)
Especifica la URL de la que se deben extraer las tablas HTML.
parámetros
-
url: la URL para extraer tablas HTML de
- opciones - un objeto JSON que define cualquier opción especial para usar al convertir la tabla HTML.
Valor de retorno
vacío
html_to_table(html, opciones)
Especifica el HTML del que se deben extraer las tablas HTML.
parámetros
-
html: el HTML para extraer tablas HTML de.
- opciones - un objeto JSON que define cualquier opción especial para usar al convertir la tabla HTML.
Valor de retorno
vacío
file_to_table(camino, opciones)
Especifica un archivo HTML del que se deben extraer las tablas HTML.
parámetros
-
ruta: la ruta del archivo HTML para extraer tablas HTML.
- opciones - un objeto JSON que define cualquier opción especial para usar al convertir la tabla HTML.
Valor de retorno
vacío
Opciones de tabla
Todas las opciones disponibles al convertir tablas HTML a CSV, XLSX o JSON.
-
customId - un identificador personalizado que puede pasar al servicio web. Esto se devolverá con la URL de devolución de llamada que ha especificado
-
tableNumberToInclude - el índice de la tabla que se convertirá, si todas las tablas de una página web se ordenan de arriba a abajo
-
format - el formato en que debe estar la tabla
- Valor predeterminado: "csv"
- Opciones: "csv", "json", "xlsx"
-
includeHeaderNames - si se incluirán nombres verdaderos de encabezado en la tabla
- Predeterminado: verdadero
-
includeAllTables - si es verdadero, todas las tablas de la página web se extraerán y cada tabla aparecerá en una hoja de cálculo separada. Solo disponible con el formato XLSX
-
targetElement - la identificación del único elemento HTML en la página web que debe usarse para extraer tablas de
-
requestAs - el tipo de agente de usuario que desea utilizar
- Predeterminado: 0
-
Opciones:
- 0 = indica que se debe usar el agente de usuario de un navegador estándar
- 1 = indica que se debe usar el agente de usuario de un navegador móvil
- 2 = indica que se debe usar el agente de usuario de un motor de búsqueda
-
country - el país la captura de pantalla debe tomarse de.
- Valor predeterminado: la ubicación más rápida actual
- Opciones: "SG", "Reino Unido", "EE. UU."
-
exportUrl - el exportar URL que especifica dónde se debe exportar la captura también
-
encryptionKey - si se especifica una clave de cifrado AES codificada con 64 base, su captura se cifra cuando se crea. Se recomienda usar el crear método de clave de cifrado para crear la clave y el descifrar métodos para descifrar la captura cifrada como se muestra en este ejemplo.
-
post - define la consulta HTTP Poststring. Cada nombre y valor en la consultastring deberá estar codificado en URL. El uso de esta opción obligará a GrabzIt a realizar una publicación HTTP.
-
address - la URL para ejecutar el código HTML. Puede ser útil si el HTML que se está convirtiendo usa URL relativas para recursos como CSS e imágenes.
-
proxy - los detalles del proxy HTTP el software del navegador debe usar para crear esta captura
Ejemplo de opciones
{
'format':'xlsx',
'includeHeaderNames':true
}
Usar la opción callBackUrl es el método recomendado para guardar un archivo
save(callBackUrl, al completar)
Save el resultado de forma asincrónica y devuelve un identificador único, que se puede utilizar para obtener la captura de pantalla con el obtener_resultado método.
parámetros
- callBackURL - el entrenador de animales el servicio GrabzIt debería llamar después de haber completado su trabajo
- oncomplete (error, id): la función de devolución de llamada, que se llama cuando se recupera el id de la captura de pantalla.
save_to(saveToArchivo, una vez completado)
Save el resultado sincrónicamente sin usar una URL de devolución de llamada.
parámetros
- saveToArchivo: la ruta del archivo que captura será saved una vez que se ha completado
- oncomplete (error, datos): la función de devolución de llamada, que se llama cuando se ha descargado la captura de pantalla. El parámetro de datos contiene los bytes de las capturas de pantalla.
get_status(id, al completar)
Obtenga el estado actual de una captura de pantalla de GrabzIt.
parámetros
-
id: el identificador único de la captura de pantalla
-
Oncomplete (error, estado) - la función de devolución de llamada, que se llama cuando se recupera el estado de la captura de pantalla.
get_cookies(dominio, incompleto)
Obtenga todas las cookies que GrabzIt está utilizando para un dominio en particular. Esto también puede incluir cookies definidas por el usuario.
parámetros
-
dominio: el dominio para devolver cookies
-
Oncomplete (error, galletas) - la función de devolución de llamada, que se llama cuando se recuperan las cookies.
set_cookie (nombre, dominio, opciones, al completar)
Establece una nueva cookie personalizada en GrabzIt, si la cookie personalizada tiene el mismo nombre y dominio que una cookie global, la cookie global se anula.
Esto puede ser útil si la funcionalidad de un sitio web está controlada por cookies.
parámetros
delete_cookie (nombre, dominio, incompleto)
Eliminar una cookie personalizada o bloquear el uso de una cookie global
parámetros
-
nombre: el nombre de la cookie a eliminar
-
dominio: el dominio del sitio web para eliminar la cookie
- oncomplete (error, éxito): la función de devolución de llamada, que se llama cuando se ha establecido la cookie. El parámetro de éxito es verdadero si se elimina la cookie; de lo contrario, es falso.
obtener_watermarks()
Obtén todas tus subidas personalizadas watermarks
parámetros
-
Oncomplete (error, watermarks) - la función de devolución de llamada, que se llama cuando el watermarks han sido recuperados. los watermark El parámetro contiene una matriz de watermarks.
obtener_watermark(identificador, al completar)
Devuelve tu costumbre watermark que coincide con el identificador especificado
parámetros
-
identificador: el identificador de una costumbre en particular watermark quieres ver
-
Oncomplete (error, watermarks) - la función de devolución de llamada, que se llama cuando el watermark ha sido recuperado. los watermarks el parámetro contiene un watermark formación.
añadir_watermark(identificador, ruta, xpos, ypos, oncomplete)
Agregar una nueva costumbre watermark
parámetros
-
identificador: el identificador que desea dar al personalizado watermark. Es importante que este identificador sea único.
-
ruta - la ruta absoluta de la watermark en su servidor. Por ejemplo C: /watermark/1.png
-
xpos: la posición horizontal en la que desea que aparezca la captura de pantalla
- Requerido
-
Opciones:
- Izquierda = 0
- Centro = 1
- Derecha = 2
-
ypos: posición vertical en la que desea que aparezca la captura de pantalla
- Requerido
-
Opciones:
- Arriba = 0
- Medio = 1
- Inferior = 2
-
oncomplete (error, éxito): la función de devolución de llamada, que se llama cuando watermark ha sido añadido. El parámetro de éxito es verdadero si el watermark bee agregado con éxito, de lo contrario falso.
Eliminar_watermark(identificador, al completar)
Eliminar una costumbre watermark
parámetros
-
identificador: el identificador de la costumbre watermark quieres borrar
-
oncomplete (error, éxito): la función de devolución de llamada, que se llama cuando watermark ha sido removido. El parámetro de éxito es verdadero si el watermark fue eliminado con éxito.
set_local_proxy (valor)
Este método permite un servidor proxy local para ser utilizado para todas las solicitudes.
parámetros
-
valor: la URL, que puede incluir un puerto si es necesario, del proxy. Proporcionar un valor nulo eliminará cualquier proxy establecido previamente
use_ssl (valor)
Especifica si las solicitudes a GrabzIt's API debe usar SSL
parámetros
-
valor: si es verdadero, todas las solicitudes a la API de GrabzIt utilizarán SSL
create_encryption_key ()
Cree una clave de cifrado 64 base criptográficamente segura, con caracteres 44 largos.
descifrar (datos, clave)
Descifre una captura cifrada utilizando la clave de cifrado proporcionada.
parámetros
decrypt_file (ruta, clave, al completar)
Descifre una captura cifrada utilizando la clave de cifrado proporcionada.
parámetros
-
ruta: la ruta de la captura cifrada
-
clave - la Clave de encriptación
- oncomplete (error): la función de devolución de llamada, que se llama cuando se descifra el archivo.
Clases de resultados
Cookies
Variables publicas
- nombre: el nombre de la cookie
- valor - el valor de la cookie
- dominio: el dominio para el que se configura la cookie
- ruta: la ruta en el dominio al que se aplica esta cookie.
- httponly: si esta cookie solo es válida cuando el sitio web se visualiza con el protocolo HTTP.
- caduca: la fecha de caducidad de esta cookie
-
tipo: el tipo de cookie que es
-
Opciones:
- Global: esta es una cookie global establecida por GrabzIt
- Local: esta es una cookie local establecida por usted
- Anulada: una cookie global que usted ha anulado
Estado
La clase que representa el estado actual de la captura de pantalla.
Variables publicas
- procesamiento: si es verdadero, la captura de pantalla todavía se está procesando.
- en caché: si es verdadero, la captura de pantalla se ha procesado y actualmente está en caché.
- expirado: si es verdadero, la captura de pantalla ya no está en el sistema GrabzIt.
- mensaje: un mensaje de error devuelto por el sistema.
WaterMark
Esta clase representa la costumbre watermarks almacenado en GrabzIt
Variables publicas
- identificador - el identificador del watermark
- formato - el formato del watermark imagen
-
xPosition: la posición x en la que watermark aparece en en la captura de pantalla
-
Opciones:
- Izquierda = 0
- Centro = 1
- Derecha = 2
-
yPosition: la posición y en la que watermark aparece en en la captura de pantalla
-
Opciones:
- Arriba = 0
- Medio = 1
- Inferior = 2