Wikibase DataModel JavaScript
Wikibase DataModel JavaScript is the JavaScript implementation of the
basic Wikibase DataModel
at the heart of the Wikibase software.
As the PHP implementation of the DataModel, this
library only implements the basic Item and Property entity types, and the components they are made
of.
Wikibase uses this library together with the
Wikibase Serialization JavaScript library
to deserialize API responses from serialized JSON to actual DataModel objects. These objects can
then be consumed and manipulated via convenient getter and setter methods, turned back into JSON via
the corresponding serializer, and send back to the API.
Release notes
6.1.0 (2019-10-24)
- Bundle some very basic Typescript types
6.0.0 (2019-10-21)
- Using CommonJS modules instead of global namespaces for all files
5.1.0 (2019-10-01)
- Added
index.js exporting all public data model parts
5.0.0 (2018-07-06)
- Remove references to fingerprint from Entity:
- Removed
Entity.getFingerprint - Removed
Entity.setFingerprint
4.1.0 (2018-06-25)
- Added new FingerprintableEntity class
- Make Item and Property inherit from it
4.0.0 (2017-10-09)
- Made the library a pure JavaScript library.
- Removed MediaWiki extension registration.
- Removed MediaWiki ResourceLoader module definitions.
- Removed WIKIBASE_DATAMODEL_JAVASCRIPT_VERSION constant.
- Raised DataValues JavaScript library version requirement to 0.10.0.
- Removed all Claim collections:
- Removed
ClaimGroup - Removed
ClaimGroupSet - Removed
ClaimList
- Removed all move-related methods from SnakList:
- Removed
SnakList.getValidMoveIndices - Removed
SnakList.move - Removed
SnakList.moveDown - Removed
SnakList.moveUp - Declared
SnakList.getFilteredSnakList private
- Removed dysfunctional methods from all Entity classes:
- Removed
Item.addStatement - Removed
Item.removeStatement - Removed
Property.addStatement - Removed
Property.removeStatement
3.1.0 (2017-09-04)
- Added an optional
hash constructor parameter and a getHash method to Snak,
PropertyValueSnak, PropertySomeValueSnak, and PropertyNoValueSnak. - Travis now runs the QUnit tests.
3.0.1 (2016-09-09)
- Fix an issue with MediaWiki loading (init.php)
3.0.0 (2016-08-02)
- Added
Set::toArray. Fingerprint::setLabel, setDescription and setAliases remove the element when null or an
empty Term or MultiTerm is given.- Removed cloning from
MultiTerm.getTexts. - Turned EntityId into a simple wrapper around an opaque serialization string
- Removed EntityId::getNumericId
- Removed EntityId::getEntityType
- Removed EntityId::getPrefixedId
- Introduced EntityId::getSerialization
- Removed
numeric-id and entity-type fields from toJSON return value - Introduced
id field to toJSON return value - Removed
numeric-id and entity-type arguments from EntityId constructor - Introduced
id argument to EntityId constructor
- Deprecated the
WIKIBASE_DATAMODEL_JAVASCRIPT_VERSION PHP constant. - The (optional) extension registration in
init.php now depends on MediaWiki >=1.25.
2.0.1 (2016-01-27)
- Added compatibility with DataValues JavaScript 0.8.0.
2.0.0 (2016-01-12)
Breaking changes
Term and MultiTerm do not accept empty language codes any more.- Removed cloning from the following methods:
GroupableCollection.toArray and List.toArrayGroup.getItemContainer and setItemContainer
- Removed
propertyId parameter from Claim.getQualifiers. SnakList.getFilteredSnakList can not be called with null any more.
Other changes
- Fixed possible performance issues due to cloning in
Group.equals and the List, Mapand Set constructors.
1.0.2 (2015-05-28)
Enhancements
- Adapt to DataValuesJavaScript 0.7.0.
- SnakList.merge() accepts null.
- Updated code documentation for being able to automatically generate a proper documentation using JSDuck.
1.0.1 (2014-11-05)
- Using DataValues JavaScript 0.6.x.
1.0.0 (2014-11-05)
Breaking changes
- Removed wikibase.datamodel.Reference.setSnaks(). Generate new Reference objects when interacting with the API to reflect hash changes performed in the back-end.
- Removed wikibase.datamodel.Entity.equals().
- Removed wikibase.datamodel.Reference.setSnaks().
- wikibase.datamodel.Reference constructor does not accept Snak object(s) any more.
- An entity cannot be constructed by passing internal object representation to Entity constructor anymore; Use entity specific constructors instead.
- Removed useless Entity.isNew(), Entity.newEmpty().
- Removed Entity.getLabel(), Entity.getLabels(), Entity.getDescription(), Entity.getDescription(), Entity.getAliases(), Entity.getAllAliases(); Acquire data via Entity.getFingerprint() instead.
- Removed Entity.getClaims(); Acquire claims/statements via Entity specific implementation.
- Item.getSiteLinks() returns a SiteLinkSet object instead of an array of SiteLink objects.
- Renamed Property.getDataType() to Property.getDataTypeId().
- Removed all toJSON(), newFromJSON(), toMap() and newFromMap() functions; Use serializers and unserializers of wikibase.serialization instead.
- Statement does not accept a plain array of references anymore; Supply a ReferenceList instead.
- Remove Claim.TYPE and Statement.TYPE attributes.
- Instead of inheriting from Claim, Statement now features a Claim instance that needs to be passed to the Statement constructor.
- Reference constructor does not accept a plain list of Snak objects anymore; Supply a proper SnakList object instead.
- SnakList constructor only accepts arrays of Snak objects.
Enhancements
- Added ClaimGroup.
- Added ClaimGroupSet.
- Added ClaimList.
- Added Fingerprint.
- Added Group.
- Added GroupableCollection.
- Added List.
- Added Map.
- Added MultiTerm.
- Added MultiTermMap.
- Added ReferenceList.
- Added SiteLinkSet.
- Added StatementGroup.
- Added StatementGroupSet.
- Added StatementList.
- Added Term.
- Added TermMap.
- Added Set.
- Added individual constructors for Item and Property.
- Added Entity.getFingerprint(), Entity.setFingerprint().
- Added SiteLink and Statement specific functionality to Item.
- Added Statement specific functionality to Property.
- Added isEmpty() and equals() functions to Item and Property.
0.3.2 (2014-08-19)
- Added wikibase.datamodel.SiteLink.
- Added wikibase.datamodel.Item.getSiteLinks().
0.3.1 (2014-08-14)
- Remove ResourceLoader dependencies on jquery and mediawiki (bug 69468)
0.3.0 (2014-07-10)
- Remove methods isSameAs and equals from wikibase.Entity
- Move all classes from wikibase to wikibase.datamodel, e. g.
wikibase.Claim becomes wikibase.datamodel.Claim
0.2.0 (2014-06-26)
- Let Entity.newFromMap expect a string instead of a DataType instance as
datatype attribute when creating a Property.
- Let Property.getDataType return the data type's string identifier instead of
a DataType instance.
- Fix regular expressions in resource loader definitions
0.1.0 (2014-06-18)
Initial release.
