bugcore is a JavaScript library that provides a foundational architecture for object oriented JS
bugcore is a JavaScript library that provides a foundational architecture for object oriented JS. It is designed to work both within node js as well as directly in the browser.
bugcore provides a basic class model based on John Resig's simple JavaScript inheritance. In addition the library provides many basic data models and utility classes for common object oriented patterns.
The library is extremely robust and makes up the foundation of our architecture for airbug so check out the docs for an overview of the full power of what the code has to offer. If the library is missing something you need, please let us know!
Creation of a new class
var Class = bugcore.Class;
var Obj = bugcore.Obj;
var SomeClass = Class.extend(Obj, {});
Creation of a new class with a constructor
var SomeClass = Class.extend(Obj, {
_constructor: function() {
this._super(); // Call super constructor
}
});
Creation of a new class with overridden equals and hashCode methods
/**
* @class
* @extends {Obj}
*/
var SomeClass = Class.extend(Obj, {
/**
* @constructs
* @param {number} a
* @param {number} b
*/
_constructor: function(a, b) {
this._super(); // Call super constructor
/**
* @private
* @type {number}
*/
this.a = a;
/**
* @private
* @type {string}
*/
this.b = b
},
/**
* @override
* @param {*} value
* @return {boolean}
*/
equals: function(value) {
if (Class.doesExtend(value, SomeClass)) {
return (Obj.equals(value.a, this.a) && Obj.equals(value.b, this.b));
}
return false;
},
/**
* @override
* @return {number}
*/
hashCode: function() {
if (!this._hashCode) {
this._hashCode = Obj.hashCode("[SomeClass]" +
Obj.hashCode(this.a) + Obj.hashCode(this.b));
}
return this._hashCode;
},
});
Use of a Map
var myMap = new bugcore.Map();
myMap.put("key1", "value1");
myMap.put("key2", "value2");
myMap.get("key1"); // "value1"
myMap.get("key2"); // "value2"
Use of a Map with instances as keys
var myMap = new bugcore.Map();
// SomeClass is from the above example that uses overridden equals and hashCode methods
var instance1 = new SomeClass(123, "abc");
var instance2 = new SomeClass(123, "abc");
myMap.put(instance1, "value");
myMap.put(instance2, "value2");
//hash codes and equality checks are equal therefore the two instances are considered
//the same key even though they are separate instances in memory
myMap.getCount(); // 1
myMap.get(instance1) // "value2"
myMap.get(instance2) // "value2"
The source is available for download from GitHub Alternatively, you can install using Node Package Manager npm
npm install bugcore
Usage:
<script type="text/javascript" src="bugcore.js"></script>
<script type="text/javascript">
var map = new bugcore.Map();
</script>
Core class used to build other classes.
Class
/**
* @constructor
*/
var Class = function() {
Getters and Setters Summary
Static Method Summary
static declare(Object declaration) :function(new:Constructor)static extend(function(new:Constructor) constructor, Object declaration) :function(new:Constructor)This method is used to declare a low level base class in the bugcore system. Most of the time you should not use this method to declare new classes unless you are sure of what you are doing. Instead use the Class.extend method and extend Obj. By using this method, it will exclude many of the base methods that the rest of the bugcore system depends upon, including hashCode, equals, _internalId, and clone
Method
/**
* @static
* @param {Object} declaration
* @return {function(new:Constructor)}
*/
Class.declare = function(declaration) {
Parameters
declaration {Object} - An object that declares the methods of the new class.Returns
Examples
var LowestLevelObject = Class.declare({
_constructor: function() {
// No need to call this._super, this is the lowest level.
}
});
Method
/**
* @static
* @param {function(new:Constructor)} constructor
* @param {Object} declaration
* @return {function(new:Constructor)}
*/
Class.extend = function(constructor, declaration) {
Parameters
constructor {function(new:Constructor)} - The constructor of the class to extend.declaration {Object} - An object that declares the methods of the new class.Returns
Examples
var BaseBall = Class.extend(Ball, {
_constructor: function(diameter) {
this._super(); // Call super constructor
this.diameter = diameter;
}
throwBall: function() {
}
});
Represents the base instantiable constructor function of all classes declared in the BugCore system using Class.declare
Class
/**
* @constructor
*/
var Constructor = function() {
Getters and Setters Summary
### Constructor#getClassGet the Class for this instance.
Method
/**
* @return {Class}
*/
getClass: function() {
Parameters
Returns
Examples
//TODO BRN: Provide example of Class usage
The root class of all other classes in the bugcore library. Provides basic functionality such as hash code support, equality checks and clone support.
Class
/**
* @class
* @implements {IClone}
* @implements {IEquals}
* @implements {IHashCode}
*/
var Obj = Class.declare({
Interfaces
Constructor Summary
Getters and Setters Summary
Method Summary
Static Method Summary
static clone(A value, boolean deep) :Astatic equals(* value1, * value2) :booleanstatic hashCode(* value) :numberMethod
/**
* @constructs
*/
_constructor: function() {
Parameters
Examples
var myObj = new Obj();
Method
/**
* @return {number}
*/
getInternalId: function() {
Parameters
Returns
Examples
var myObj = new Obj();
var internalId = myObj.getInternalId();
By default the clone method will use the instance's Class to instantiate a new instance. It will also iterate through the instance's properties and attempt to clone all properties that are not functions. If a deep clone is being performed, then the clone method will attempt to create a deep copy of each property. If a shallow clone is being performed then a reference to the property value will be set on the new instance.
NOTE: _internalId is not cloned for deep or shallow clones. Therefore the clone instance is unique from that of the original.
Method
/**
* @param {boolean=} deep
* @return {*}
*/
clone: function(deep) {
Parameters
deep {boolean=} - Whether or not to perform a deep clone. Optional - default: falseReturns
Examples
var myObj = new Obj();
var shallowCloneObj = myObj.clone(); //shallow clone
var deepCloneObj = myObj.clone(true); //deep clone
By default, the equality check will compare this instances _internalId to the value parameter.
Method
/**
* @param {*} value
* @return {boolean}
*/
equals: function(value) {
Parameters
value {*} - The value to compare to for equality.Returns
Examples
Two different instances are not equal
var obj1 = new Obj();
var obj2 = new Obj();
obj1.equals(obj2); //false
An instance is equal to itself
var obj1 = new Obj();
obj1.equals(obj1); //true
Clones are not equal unless the 'equals' method is overridden
var obj = new Obj();
var objClone = obj.clone();
obj.equals(objClone); //false
var obj = new Obj();
var objClone = obj.clone(true);
obj.equals(objClone); //false
NOTE: If two instances are equal, they should return the same hash code. NOTE: Equal hash codes is not a guarantee of equality.
Method
/**
* @return {number}
*/
hashCode: function() {
Parameters
Returns
Examples
Get hash code of instance
var obj = new Obj();
var hashCode = obj.hashCode();
Clones the value parameter.
If the value implements IClone the clone() method will be called to perform a clone of the value. If the value is a basic value such as a number or string it will simply be passed through.
Method
/**
* @static
* @param {A} value
* @param {boolean=} deep
* @return {A}
* @template A
*/
Obj.clone = function(value, deep) {
Parameters
value {A} - The value to clone.deep {boolean=} - Whether or not to perform a deep clone. Optional - default: falseReturns
Examples
var myObj = new Obj();
var shallowCloneObj = Obj.clone(myObj); //shallow clone
var myObj = new Obj();
var deepCloneObj = Obj.clone(myObj, true); //deep clone
var myString = "abc123";
var cloneString = Obj.clone(myString); //"abc123"
Checks value1 and value2 for equality.
If value1 implements IEquals, the value1.equals() method will be used to perform the equality check. Otherwise === is used to compare the two values.
Method
/**
* @static
* @param {*} value1
* @param {*} value2
* @return {boolean}
*/
Obj.equals = function(value1, value2) {
Parameters
value1 {*} - The value to compare value2 to for equality.value2 {*} - The value to compare value1 to for equality.Returns
Examples
Two different instances are not equal
var obj1 = new Obj();
var obj2 = new Obj();
Obj.equals(obj1, obj2); //false
An instance is equal to itself
var obj1 = new Obj();
Obj.equals(obj1, obj1); //true
Strings of the same value are equal
var string1 = "mystring";
var string2 = "mystring";
Obj.equals(string1, string2) //true
Undefined and null are not equal
var undefinedValue = undefined;
var nullValue = null;
Obj.equals(undefinedValue, nullValue) //false
Returns the hashCode of the value. If the value implements IHashCode, then the value.hashCode() method will be used to generate the hash code.
Method
/**
* @static
* @param {*} value
* @return {number}
*/
Obj.hashCode = function(value) {
Parameters
value {*} - The value to generate a hash code for..Returns
Examples
Get hash code of an instance.
var myObj = new Obj();
var hashCode = Obj.hashCode(myObj);
Get hash code of a string.
var myString = "abc123";
var hashCode = Obj.hashCode(myString);
FAQs
bugcore is a JavaScript library that provides a foundational architecture for object oriented JS
The npm package bugcore receives a total of 62 weekly downloads. As such, bugcore popularity was classified as not popular.
We found that bugcore demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.