El mal uso, por diseño
Por qué importa La mayoría de los errores en la frontera de una API no están en la API. Están en alguien que la llamó de una forma que parecía bien e hizo en silencio lo incorrecto. No puedes arreglar a cada llamador; puedes hacer que el uso incorrecto sea imposible, o ruidoso.
Un asistente que escribe una API tiende a ser servicial: si envías antes de conectar, conecta por ti; si pasas una cadena donde se esperaban bytes, la codifica; si olvidas una opción, hay un valor por defecto. Cada amabilidad esconde un error hasta que sale a la luz en algún sitio lejano.
Fallar pronto, fallar en voz alta: lanzar un error justo en la llamada que está mal, antes de que haya cambiado nada, con un mensaje que diga qué se esperaba.
Cuatro herramientas
- Estados explícitos: un objeto que sabe si es nuevo, está abierto o está cerrado, y rechaza las llamadas que no encajan.
- Opciones con nombre, sin booleanos:
mode="dry_run"no se puede intercambiar por accidente con otro indicador;copy(a, b, True, False)sí. - Sin valores por defecto silenciosos para decisiones que son peligrosas de equivocar: obliga al llamador a decirlo.
- Tipos que llevan significado: un dinero que conoce su moneda no se puede sumar a dinero en otra.
En este módulo, unos scripts ocultos de mal uso llaman mal a tu API y esperan un error en la llamada incorrecta, sin que haya cambiado nada. Los scripts de uso correcto esperan que simplemente funcione. Cada problema enumera los malos usos de los que protegerse.
Resumen Las suposiciones serviciales esconden errores. Rechaza el uso incorrecto en la llamada que está mal, antes de cualquier efecto.
¿Has visto un problema en esta lección? Avísanos · Preguntar sobre esta lección
Este ejercicio se abre pronto
Termina la lección anterior y esta se desbloquea. Todo el curso es gratis, no hace falta cuenta, y puedes leer esta lección ahora mismo.
Este navegador está bloqueando las cookies de learn.floati.life, así que las lecciones que terminaste aquí no se pueden abrir en orden. Permite las cookies de este sitio y recarga.