0.0.7 • Published 8 years ago
3-way-merge v0.0.7
merge(o, a, b) -> c
3-way merging of JavaScript objects
Takes 3 versions of the same object -- where version 2 and 3 are both derived from version 1 -- and generates a 4th version, effectively merging version 2 and 3 together. When a conflict is detected (changes made in both version 2 and 3) changes from version 3 are used.
Prototype
merge(Object original, Object current, Object new) -> Object
original
: Ancestor version (original) from which bothversionA
andversionB
are derivedcurrent
: Version A oforiginal
new
: Version B oforiginal
Example:
// The original version which both A and B are derived from
original = {
aliases: {
abc: "Abc"
},
deleted: 7890,
key: "string",
list: [
"abc",
"def"
],
value: 1234
}
// Version A
current = {
aliases: {
"abc": "Abcdef",
"def": "Def"
},
list: [
"abc",
"cat",
"def",
"xyz"
],
value: 123456
}
// Version B
B = {
aliases: {
abc: "Abc",
aab: "Aab"
},
list: [
"abc",
"zzz"
],
value: 1234
}
// --> Merged result
{
aliases: {
abc: "Abcdef",
aab: "Aab",
def: "Def"
},
list: [
"abc",
"cat",
"xyz",
"zzz"
],
value: 123456
}
Requirements
Array.isArray(object) -> Boolean
to be implemented (which it is already in modern JavaScript environments)