Programma Les 67 van 148 · API's die niemand misbruikt
API's die niemand misbruikt

Misbruik door ontwerp

Waarom dit ertoe doet De meeste bugs bij een API-grens zitten niet in de API. Ze zitten in een aanroeper die het op een manier gebruikte die er goed uitzag en stilletjes het verkeerde deed. Je kunt niet elke aanroeper repareren; je kunt verkeerd gebruik onmogelijk maken of luid laten zijn.

Een assistent die een API schrijft is vaak behulpzaam: als je verzendt voor het verbinden, verbindt het voor je; als je een string doorgeeft waar bytes werden verwacht, encodeert het deze; als je een optie vergeet, is er een standaardwaarde. Elke vriendelijkheid verbergt een fout tot deze ergens ver weg naar boven komt.

Faal vroeg, faal luidruchtig: gooi een error bij de exacte call die fout is, voordat er iets is veranderd, met een bericht dat zegt wat werd verwacht.

Vier tools

  • Expliciete toestanden: een object dat weet of het nieuw, open of gesloten is, en oproepen weigert die niet passen.
  • Genomde opties, geen booleans: mode="dry_run" kan niet per ongeluk worden verwisseld met een andere flag; copy(a, b, True, False) kan dat wel.
  • Geen stille standaardwaarden voor keuzes die gevaarlijk zijn om fout te maken: laat de aanroeper het zeggen.
  • Types die betekenis dragen: geld dat zijn valuta kent kan niet worden bijgevoegd aan geld in een andere.

In deze module roepen scripts met verborgen misbruik je API verkeerd aan en verwachten een fout bij de verkeerde aanroep, zonder dat er iets verandert. Scripts voor correct gebruik verwachten dat het gewoon werkt. Elk probleem bevat een lijst van misbruiken om tegen te beschermen.

Samenvatting Handige gokken verbergen bugs. Weiger fout gebruik bij de call die fout is, voor elk effect.

Een probleem ontdekt in deze les? Meld het · Vraag naar deze les

Deze oefening opent binnenkort

Maak de les ervoor af voordat deze wordt ontgrendeld. De hele cursus is gratis, geen account nodig, en je kunt deze les nu lezen.