bindNodeCallback
Convierte una callback API del estilo de Node.js a una función que retorna un Observable
Descripción
Es igual que bindCallback, pero la callback debe ser de tipo callback(error, result).
bindNodeCallback no es un operador, dado que ni su entrada ni su salida son Observables.
De entrada recibe una función func que recibe algunos parámetros, pero el último parámetro debe ser una función callback, a la que func llama cuando ha terminado. La función callback debe seguir las convenciones de Node.js, donde el primer argumento de la callback es un objeto error, que señala si la llamada ha sido realizada o no con éxito. Si dicho objeto se le pasa a la callback, significa que algo ha ido mal.
La salida de bindNodeCallback es una función que recibe los mismo parámetros que func, excepto el último (la callback.) Cuando se hace una llamada a la función de salida con argumentos, retornará un Observable. Si func hace una llamada a su callback con el parámetro de error presente, el Observable lanzará un error con ese valor. Si no se proporciona el parámetro de error, el Observable emitirá el segundo parámetro. Si hay más parámetros (tercero, cuarto etc.), el Observable emitirá un array con todos los argumentos, excepto el primer argumento de error.
Nota: la llamada a func no se realizará en el mismo momento en el que se haga la llamada a la función de salida, sino en el momento en el que el Observable resultante sea suscrito. Por defecto, la llamada a func se hará de forma síncrona tras la suscripción, pero este comportamiento se puede cambiar proporcionando un planificador como tercer parámetro (opcional). SchedulerLike también puede controlar cuándo se emiten los valores de la callback en el Observable resultante. Para saber más, leer la sección de bindCallback, ya que el comportamiento de SchedulerLike en ambos operadores es exactamente igual.
Al igual que con bindCallback, el contexto (this) de la función de entrada será que tenga la función de salida en el momento en el que se llame.
Una vez que el Observable resultante emita un valor, se completará inmediatamente. Esto implica que si la función func vuelve a llamar a la callback, los valores de la segunda y demás llamadas nunca aparecerán en el flujo. Si se necesita manejar funciones que llaman a la callback varias veces, se debe utilizar fromEvent o fromEventPattern.
Nota: bindNodeCallback se puede utilizar en entornos distintos a Node.js. Las callbacks del 'estilo de Node.js' son una convención, por lo que si la API que se quiera utilizar implementa este tipo de callback, ya sea en el navegador o cualquier otro entorno, bindNodeCallback se puede utilizar de forma segura con las funciones de dicha API.
El objeto Error que se le pasa a la callback no tiene por qué ser una instancia del objeto Error nativo de JavaScript. De hecho, ni siquiera tiene que ser un objeto. El parámetro Error de la función callback se interpreta como 'presente', cuando el valor del parámetro es truthy (verdadero). El parámetro podría ser, por ejemplo, un número distinto de cero, una cadena que no esté vacía o el valor booleano true. En todos estos casos, el Observable resultante lanzaría un error con ese valor. Esto implica que, normalmente, las callbacks tradicionales fallarán muy a menudo cuando se utiliza bindNodeCallback. Si un Observable falla mucho más a menudo de lo que cabría esperar, se aconseja comprobar si la callback realmente se está llamando al estilo de Node.js, y si no, se debería utilizar el operador bindCallback en lugar de bindNodeCallback.
Nota: aunque el parámetro de error esté presente en la callback, si su valor es falsy (falso), no aparecerá en el array emitido por el Observable resultante.
Ejemplos
Ejemplos de la documentación oficial
Leer un fichero del sistema de ficheros y obtener los datos en forma de Observable
Usar bindNodeCallback en una función llamando a una callback con varios argumentos
Usar bindNodeCallback con una función llamando a una callback al estilo normal
Recursos adicionales
Last updated
