Ik heb Claude Code gevraagd jQuery te verwijderen. Het mislukte jammerlijk

Ik vroeg Claude Code om jQuery te verwijderen. Het mislukte jammerlijk

Het verwijderen van jQuery uit een oude codebase klinkt op papier eenvoudig; het is in de praktijk een van de meest bedrieglijk verraderlijke refactoren die een ontwikkelaar kan proberen. Ik gaf de taak over aan Claude Code, een AI-codeerassistent, in de verwachting dat er een schone migratie naar standaard JavaScript zou plaatsvinden, en wat volgde was een cascade van kapotte gebeurtenishandlers, ontbrekende AJAX-abstracties en diepgewortelde plug-in-afhankelijkheden die het project op de knieën brachten.

Waarom klonk het verwijderen van jQuery als een goed idee?

De pitch was overtuigend: moderne browsers hebben de compatibiliteitskloof gedicht die jQuery in 2009 essentieel maakte. Vanilla JavaScript handelt nu native DOM-manipulatie, ophaalverzoeken en gebeurtenisdelegatie af. Door jQuery te verwijderen, wordt 87 KB van een bundel geschrapt (verkleind + gzipped), de Lighthouse-scores verbeterd en een afhankelijkheid geëlimineerd die steeds minder onderhoudsaandacht krijgt.

Onze codebase was een middelgroot SaaS-dashboard met ongeveer 140.000 regels JavaScript, verzameld over zes jaar. jQuery was overal aanwezig: niet alleen in hulpprogrammafuncties, maar ook verweven in plug-ins van derden, oudere formuliervalidatie en zelfs enkele door de server gegenereerde gedeeltelijke sjablonen. Het refactoroppervlak was enorm, en ik ging er naïef van uit dat een AI-tool het als ontbijt zou opeten.

Wat gebeurde er eigenlijk toen Claude Code het probeerde?

De eerste passage was bemoedigend. Claude Code heeft de aanroepen van $(document).ready() correct geïdentificeerd en vervangen door DOMContentLoaded-listeners. Eenvoudige $.ajax()-aanroepen worden netjes omgezet in fetch(). Wat het laaghangende fruit betreft, presteerde de AI bewonderenswaardig.

Toen kwamen de plug-ins. Onze codebase was gebaseerd op Select2, DataTables en een aangepaste datumbereikkiezer – allemaal afhankelijk van jQuery. Claude Code stelde voor om ze te vervangen door moderne alternatieven, wat op zichzelf een correct advies is, maar hield geen rekening met de rimpeleffecten. Door Select2 te ruilen voor Choices.js zijn de initialisatie-API, de gebeurtenisnamen en het databindingscontract gewijzigd. Claude Code verving de import en ging verder, waarbij gebroken referenties in 23 componenten onaangeroerd bleven.

Erger nog, de AI worstelde met indirect jQuery-gebruik – plaatsen waar vanilla JS technisch werd geschreven, maar resultaten doorgaf via jQuery-hulpprogrammafuncties zoals $.extend() of $.isPlainObject(). Het heeft deze tijdens de analyse volledig gemist.

"AI-coderingstools blinken uit in patroonvervanging. Ze worstelen met het in kaart brengen van systemische afhankelijkheid - niet alleen begrijpen waar een bibliotheek wordt genoemd, maar ook welke contracten deze impliciet afdwingt in een codebase."

Wat zijn de echte uitdagingen van een jQuery-naar-Vanilla-migratie?

De mislukking bracht structurele problemen aan het licht die geen enkel instrument – mens of AI – kan omzeilen zonder de juiste voorbereiding:

Verborgen plug-incontracten: jQuery-plug-ins zijn afhankelijk van het interne gebeurtenissysteem van jQuery ($.fn-extensies, gedelegeerde evenementen). Als u de hostbibliotheek verwisselt, worden alle plug-ins tegelijkertijd ongeldig, niet stapsgewijs.

Verschillen in foutafhandeling in AJAX: jQuery's $.ajax() verpakt fouten in een genormaliseerd object. De Fetch API signaleert netwerkfouten, maar lost op bij 4xx/5xx-reacties: een gedragsinversie die elke bestaande foutafhandelaar verbreekt.

Animatieabstracties: $.animate(), .fadeIn() en .slideUp() hebben geen directe equivalenten; CSS-overgangen vereisen structurele markup-wijzigingen, niet alleen JavaScript-swaps.

Verschillen in de selectorengine: de Sizzle-engine van jQuery ondersteunt pseudo-selectors zoals :visible en :has() die querySelectorAll() niet native verwerkt.

Aannames over de globale status: Oude code muteert vaak het jQuery-object of vertrouwt op de volgorde van plug-ins: aannames die onzichtbaar zijn voor statische analyse.

Claude Code heeft ongeveer 60% van de vereiste wijzigingen correct geïdentificeerd. Voor de resterende 40% was een menselijke ontwikkelaar nodig die de gedragscontracten begreep, en niet alleen de syntaxis.

Hoe moeten ontwikkelaars deze migratie eigenlijk aanpakken?

De juiste strategie is stapsgewijs en grensgestuurd, niet op grote schaal. In plaats van jQuery eruit te rippen

Related Posts

• CXMT biedt DDR4-chips aan tegen ongeveer de helft van de geldende marktprijs
• Goede en praktische point-to-analyse voor onvolledige C-programma's [pdf]
• De weinig bekende opdrachtregel-sandboxtool van macOS (2025)
• Toon HN: Knock-Knock.net – Visualiseer de bots die op de deur van mijn server kloppen