libzotero
Version:
javascript libZotero
582 lines (572 loc) • 22.4 kB
HTML
<html lang="en">
<head>
<title>Code coverage report for src/Writer.js</title>
<meta charset="utf-8" />
<link rel="stylesheet" href="../prettify.css" />
<link rel="stylesheet" href="../base.css" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<style type='text/css'>
.coverage-summary .sorter {
background-image: url(../sort-arrow-sprite.png);
}
</style>
</head>
<body>
<div class='wrapper'>
<div class='pad1'>
<h1>
<a href="../index.html">all files</a> / <a href="index.html">src/</a> Writer.js
</h1>
<div class='clearfix'>
<div class='fl pad1y space-right2'>
<span class="strong">9.89% </span>
<span class="quiet">Statements</span>
<span class='fraction'>9/91</span>
</div>
<div class='fl pad1y space-right2'>
<span class="strong">0% </span>
<span class="quiet">Branches</span>
<span class='fraction'>0/26</span>
</div>
<div class='fl pad1y space-right2'>
<span class="strong">0% </span>
<span class="quiet">Functions</span>
<span class='fraction'>0/11</span>
</div>
<div class='fl pad1y space-right2'>
<span class="strong">9.89% </span>
<span class="quiet">Lines</span>
<span class='fraction'>9/91</span>
</div>
</div>
</div>
<div class='status-line low'></div>
<pre><table class="coverage">
<tr><td class="line-count quiet">1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173</td><td class="line-coverage quiet"><span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1×</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1×</span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1×</span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1×</span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1×</span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1×</span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1×</span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1×</span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-no"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-neutral"> </span>
<span class="cline-any cline-yes">1×</span></td><td class="text"><pre class="prettyprint lang-js">'use strict';
var log = require('./Log.js').Logger('libZotero:Writer');
var Writer = <span class="fstat-no" title="function not covered" >function(libraryType, libraryID, apiKey){</span>
<span class="cstat-no" title="statement not covered" > this.libraryType = libraryType;</span>
<span class="cstat-no" title="statement not covered" > this.libraryID = libraryID;</span>
<span class="cstat-no" title="statement not covered" > this.apiKey = apiKey;</span>
};
Writer.prototype.writeObjects = <span class="fstat-no" title="function not covered" >function(objectsArray, target){</span>
<span class="cstat-no" title="statement not covered" > let libraryType = this.libraryType;</span>
<span class="cstat-no" title="statement not covered" > let libraryID = this.libraryID;</span>
<span class="cstat-no" title="statement not covered" > let rc = new Zotero.RequestConfig().LibraryType(libraryType).LibraryID(libraryID);</span>
<span class="cstat-no" title="statement not covered" > rc.Key(this.apiKey);</span>
<span class="cstat-no" title="statement not covered" > rc.Target(target);</span>
<span class="cstat-no" title="statement not covered" > let writeChunks = chunkObjectsArray(objectsArray);</span>
<span class="cstat-no" title="statement not covered" > let rawChunkObjects = rawChunks(writeChunks);</span>
//update object with server response if successful
<span class="cstat-no" title="statement not covered" > var writeSuccessCallback = <span class="fstat-no" title="function not covered" >function(response){</span></span>
<span class="cstat-no" title="statement not covered" > log.debug('write successCallback', 3);</span>
<span class="cstat-no" title="statement not covered" > updateObjectsFromWriteResponse(this.writeChunk, response);</span>
<span class="cstat-no" title="statement not covered" > response.returnObjects = this.writeChunk;</span>
<span class="cstat-no" title="statement not covered" > return response;</span>
};
<span class="cstat-no" title="statement not covered" > var requestObjects = [];</span>
<span class="cstat-no" title="statement not covered" > writeChunks.forEach((writeChunk, i)=>{</span>
<span class="cstat-no" title="statement not covered" > var successContext = {writeChunk};</span>
<span class="cstat-no" title="statement not covered" > var requestData = JSON.stringify(rawChunkObjects[i]);</span>
<span class="cstat-no" title="statement not covered" > requestObjects.push({</span>
url: rc.config,
type: 'POST',
data: requestData,
processData: false,
success: writeSuccessCallback.bind(successContext)
});
});
<span class="cstat-no" title="statement not covered" > return Zotero.net.queueRequest(requestObjects)</span>
.then(<span class="fstat-no" title="function not covered" >function(responses){</span>
<span class="cstat-no" title="statement not covered" > log.debug('Done with writeObjects sequentialRequests promise', 3);</span>
<span class="cstat-no" title="statement not covered" > return responses;</span>
});
};
//accept an array of 'Zotero.Item's
Writer.prototype.writeItems = <span class="fstat-no" title="function not covered" >function(itemsArray){</span>
<span class="cstat-no" title="statement not covered" > let writeItems = atomizeItems(itemsArray);</span>
<span class="cstat-no" title="statement not covered" > return this.writeObjects(writeItems, 'items');</span>
};
//take an array of items and extract children into their own items
//for writing
var atomizeItems = <span class="fstat-no" title="function not covered" >function(itemsArray){</span>
//process the array of items, pulling out child notes/attachments to write
//separately with correct parentItem set and assign generated itemKeys to
//new items
<span class="cstat-no" title="statement not covered" > var writeItems = [];</span>
<span class="cstat-no" title="statement not covered" > var item;</span>
<span class="cstat-no" title="statement not covered" > for(var i = 0; i < itemsArray.length; i++){</span>
<span class="cstat-no" title="statement not covered" > item = itemsArray[i];</span>
//generate an itemKey if the item does not already have one
<span class="cstat-no" title="statement not covered" > var itemKey = item.get('key');</span>
<span class="cstat-no" title="statement not covered" > if(itemKey === '' || itemKey === null) {</span>
<span class="cstat-no" title="statement not covered" > var newItemKey = Zotero.utils.getKey();</span>
<span class="cstat-no" title="statement not covered" > item.set('key', newItemKey);</span>
<span class="cstat-no" title="statement not covered" > item.set('version', 0);</span>
}
//items that already have item key always in first pass, as are their children
<span class="cstat-no" title="statement not covered" > writeItems.push(item);</span>
<span class="cstat-no" title="statement not covered" > if(item.hasOwnProperty('notes') && item.notes.length > 0){</span>
<span class="cstat-no" title="statement not covered" > for(var j = 0; j < item.notes.length; j++){</span>
<span class="cstat-no" title="statement not covered" > item.notes[j].set('parentItem', item.get('key'));</span>
}
<span class="cstat-no" title="statement not covered" > writeItems = writeItems.concat(item.notes);</span>
}
<span class="cstat-no" title="statement not covered" > if(item.hasOwnProperty('attachments') && item.attachments.length > 0){</span>
<span class="cstat-no" title="statement not covered" > for(var k = 0; k < item.attachments.length; k++){</span>
<span class="cstat-no" title="statement not covered" > item.attachments[k].set('parentItem', item.get('key'));</span>
}
<span class="cstat-no" title="statement not covered" > writeItems = writeItems.concat(item.attachments);</span>
}
}
<span class="cstat-no" title="statement not covered" > return writeItems;</span>
};
//split an array of objects into chunks to write over multiple api requests
var chunkObjectsArray = <span class="fstat-no" title="function not covered" >function(objectsArray){</span>
<span class="cstat-no" title="statement not covered" > var chunkSize = 50;</span>
<span class="cstat-no" title="statement not covered" > var writeChunks = [];</span>
<span class="cstat-no" title="statement not covered" > for(var i = 0; i < objectsArray.length; i = i + chunkSize){</span>
<span class="cstat-no" title="statement not covered" > writeChunks.push(objectsArray.slice(i, i+chunkSize));</span>
}
<span class="cstat-no" title="statement not covered" > return writeChunks;</span>
};
var rawChunks = <span class="fstat-no" title="function not covered" >function(chunks){</span>
<span class="cstat-no" title="statement not covered" > var rawChunkObjects = [];</span>
<span class="cstat-no" title="statement not covered" > for(var i = 0; i < chunks.length; i++){</span>
<span class="cstat-no" title="statement not covered" > rawChunkObjects[i] = [];</span>
<span class="cstat-no" title="statement not covered" > for(var j = 0; j < chunks[i].length; j++){</span>
<span class="cstat-no" title="statement not covered" > rawChunkObjects[i].push(chunks[i][j].writeApiObj());</span>
}
}
<span class="cstat-no" title="statement not covered" > return rawChunkObjects;</span>
};
//update items appropriately based on response to multi-write request
//for success:
// update objectKey if item doesn't have one yet (newly created item)
// update itemVersion to response's Last-Modified-Version header
// mark as synced
//for unchanged:
// don't need to do anything? itemVersion should remain the same?
// mark as synced if not already?
//for failed:
// add the failure to the object under writeFailure
// don't mark as synced
// calling code should check for writeFailure after the written objects
// are returned
var updateObjectsFromWriteResponse = <span class="fstat-no" title="function not covered" >function(objectsArray, response){</span>
<span class="cstat-no" title="statement not covered" > log.debug('updateObjectsFromWriteResponse', 3);</span>
<span class="cstat-no" title="statement not covered" > log.debug('statusCode: ' + response.status, 3);</span>
<span class="cstat-no" title="statement not covered" > var data = response.data;</span>
<span class="cstat-no" title="statement not covered" > if(response.status == 200){</span>
<span class="cstat-no" title="statement not covered" > log.debug('newLastModifiedVersion: ' + response.lastModifiedVersion, 3);</span>
//make sure writes were actually successful and
//update the itemKey for the parent
<span class="cstat-no" title="statement not covered" > if(data.hasOwnProperty('success')){</span>
//update each successfully written item, possibly with new itemKeys
<span class="cstat-no" title="statement not covered" > Object.keys(data.success).forEach(<span class="fstat-no" title="function not covered" >function(ind){</span></span>
<span class="cstat-no" title="statement not covered" > var i = parseInt(ind, 10);</span>
<span class="cstat-no" title="statement not covered" > var key = data.success[ind];</span>
<span class="cstat-no" title="statement not covered" > var object = objectsArray[i];</span>
//throw error if objectKey mismatch
<span class="cstat-no" title="statement not covered" > if(object.key !== '' && object.key !== key){</span>
<span class="cstat-no" title="statement not covered" > throw new Error('object key mismatch in multi-write response');</span>
}
<span class="cstat-no" title="statement not covered" > if(object.key === ''){</span>
<span class="cstat-no" title="statement not covered" > object.updateObjectKey(key);</span>
}
<span class="cstat-no" title="statement not covered" > object.set('version', response.lastModifiedVersion);</span>
<span class="cstat-no" title="statement not covered" > object.synced = true;</span>
<span class="cstat-no" title="statement not covered" > object.writeFailure = false;</span>
});
}
<span class="cstat-no" title="statement not covered" > if(data.hasOwnProperty('failed')){</span>
<span class="cstat-no" title="statement not covered" > log.debug('updating objects with failed writes', 3);</span>
<span class="cstat-no" title="statement not covered" > Object.keys(data.failed).forEach(<span class="fstat-no" title="function not covered" >function(ind){</span></span>
<span class="cstat-no" title="statement not covered" > var failure = data.failed[ind];</span>
<span class="cstat-no" title="statement not covered" > log.error('failed write ' + ind + ' - ' + failure);</span>
<span class="cstat-no" title="statement not covered" > var i = parseInt(ind, 10);</span>
<span class="cstat-no" title="statement not covered" > var object = objectsArray[i];</span>
<span class="cstat-no" title="statement not covered" > object.writeFailure = failure;</span>
});
}
}
else <span class="cstat-no" title="statement not covered" >if(response.status == 204){</span>
//single item put response, this probably should never go to this function
<span class="cstat-no" title="statement not covered" > objectsArray[0].synced = true;</span>
}
};
module.exports = Writer;</pre></td></tr>
</table></pre>
<div class='push'></div><!-- for sticky footer -->
</div><!-- /wrapper -->
<div class='footer quiet pad2 space-top1 center small'>
Code coverage
generated by <a href="http://istanbul-js.org/" target="_blank">istanbul</a> at Wed Apr 12 2017 14:32:53 GMT+0100 (BST)
</div>
</div>
<script src="../prettify.js"></script>
<script>
window.onload = function () {
if (typeof prettyPrint === 'function') {
prettyPrint();
}
};
</script>
<script src="../sorter.js"></script>
</body>
</html>