jayphelps/core-decoratorsArchived
Core Decorators
core-decorators est une bibliothèque de décorateurs de classe JavaScript et un utilitaire de framework pour étendre les fonctionnalités des classes. Elle fournit une collection d'outils pour implémenter des mixins de comportement de classe, automatiser la liaison des méthodes pour éviter la configuration manuelle dans le constructeur, et vérifier que les méthodes des sous-classes surchargent correctement celles des parents.
La bibliothèque inclut une boîte à outils de dépréciation de code pour marquer les méthodes obsolètes avec des avertissements dans la console, ainsi qu'un profileur d'exécution de fonctions pour mesurer les performances et la durée. Elle permet en outre de modifier le comportement des classes et des méthodes via un système de décorateurs personnalisés et d'injection de logique partagée.
Ses capacités supplémentaires couvrent le contrôle des propriétés d'objet, y compris l'application de propriétés en lecture seule et la restriction de visibilité des propriétés. La boîte à outils fournit également des primitives de performance telles que la mise en cache des résultats et l'initialisation différée des propriétés pour retarder l'exécution jusqu'au premier accès.
Features
- Behavioral Injection - Provides a comprehensive system of decorators for injecting shared behaviors and custom logic into JavaScript classes.
- Class Mixins - Implements class behavior mixins to inject shared functionality from multiple sources into a single target class.
- Override Validations - Ensuring that subclass methods correctly override parent methods to prevent accidental naming collisions or signature mismatches.
- Automatic Context Binding - Automatically binds class methods to their instances to ensure the correct context is maintained during callbacks.
- Function Context Binding - Provides utilities to permanently bind the this context to class instances for consistent function execution.
- Function Decorators - Allows wrapping methods with custom helper functions or third-party utilities to augment their behavior.
- Object Method Binding - Automatically associates class methods with their respective instances to avoid manual constructor binding.
- General Purpose Mixins - Implements reusable class fragments to inject shared behavior across diverse class hierarchies.
- Higher-Order Function Wrapping - Augments method behavior by wrapping original functions with helper logic for profiling, caching, or warning suppression.
- Class Decorators - Provides a collection of class decorators to modify and extend the behavior of JavaScript classes and methods.
- Automatic Method Binding - Ensures class methods maintain a permanent reference to the class instance without requiring manual constructor binding.
- API Deprecation Tooling - Marks outdated methods as deprecated to warn developers and guide them toward newer API alternatives.
- Override Enforcement - Verifies that subclass methods correctly override parent class methods to ensure architectural integrity.
- Override Validation - Verifies that subclass methods correctly override parent class methods to prevent naming collisions and signature mismatches.
- Override Verification - Verifies that subclass methods correctly override parent methods to prevent naming collisions and signature mismatches.
- Deprecated Feature Markings - Provides a mechanism to flag methods as obsolete to warn developers through console warnings.
- Lazy Property Initialization - Implements deferred property initialization to delay execution and reduce memory allocations until first access.
- Method Wrapping - Applies external functions and arguments to a method to wrap it with custom logic.
- Property Descriptors - Manipulates property descriptors to control the enumerability, writability, and configurability of class members.
- Object Property Descriptor Controls - Enforces stricter data integrity by restricting property visibility and marking class members as read-only.
- API Deprecation Notifications - Emits custom console warnings and URLs when deprecated methods are invoked to notify developers.
- Developer Deprecation Warnings - Provides a toolkit for flagging obsolete methods with console warnings to guide developers during codebase migration.
- Function Execution Timing - Tracks the elapsed time of function execution using console timing labels to identify bottlenecks.
- Function Execution Timers - Measures the execution time of functions using browser console timers via decorators.
- Performance Profilers - Triggers browser profiling using console timers for single runs or specific time intervals.
- Performance Profiling - Includes tools to monitor execution time and resource usage to identify performance bottlenecks.
