Semantic Patches for Adaptation of JavaScript Programs to Evolving Libraries

Benjamin Barslev Nielsen*, Martin Toldam Torp, Anders Møller

*Corresponding author for this work

Research output: Contribution to book/anthology/report/proceedingArticle in proceedingsResearchpeer-review

199 Downloads (Pure)


JavaScript libraries are often updated and sometimes breaking changes are introduced in the process, resulting in the client developers having to adapt their code to the changes. In addition to locating the affected parts of their code, the client developers must apply suitable patches, which is a tedious, error-prone, and entirely manual process.

To reduce the manual effort, we present JSFIX. Given a collection of semantic patches, which are formalized descriptions of the breaking changes, the tool detects the locations affected by breaking changes and then transforms those parts of the code to become compatible with the new library version. JSFIX relies on an existing static analysis to approximate the set of affected locations, and an interactive process where the user answers questions about the client code to filter away false positives.

An evaluation involving 12 popular JavaScript libraries and 203 clients shows that our notion of semantic patches can accurately express most of the breaking changes that occur in practice, and that JSFIX can successfully adapt most of the clients to the changes. In particular, 31 clients have accepted pull requests made by JSFIX, indicating that the code quality is good enough for practical usage. It takes JSFIX only a few seconds to patch, on average, 3.8 source locations affected by breaking changes in each client, with only 2.7 questions to the user, which suggests that the approach can significantly reduce the manual effort required when adapting JavaScript programs to evolving libraries.

Original languageEnglish
Title of host publicationProceedings - 2021 IEEE/ACM 43rd International Conference on Software Engineering, ICSE 2021
Number of pages12
Publication date2021
ISBN (Print)9781665402965
ISBN (Electronic)9780738113197
Publication statusPublished - 2021
Event43rd International Conference on Software Engineering (ICSE) - Madrid, Spain
Duration: 22 May 202130 May 2021


Conference43rd International Conference on Software Engineering (ICSE)


Dive into the research topics of 'Semantic Patches for Adaptation of JavaScript Programs to Evolving Libraries'. Together they form a unique fingerprint.

Cite this