prismic.io
Version:
JavaScript development kit for prismic.io
359 lines (307 loc) • 13.6 kB
HTML
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>JSDoc: Source: predicates.js</title>
<script src="scripts/prettify/prettify.js"> </script>
<script src="scripts/prettify/lang-css.js"> </script>
<!--[if lt IE 9]>
<script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
<![endif]-->
<link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
<link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
</head>
<body>
<div id="main">
<h1 class="page-title">Source: predicates.js</h1>
<section>
<article>
<pre class="prettyprint source linenums"><code>"use strict";
function stripQuotes(s) {
return s.replace(/"/g, "");
}
function toQueryValue(value) {
if (typeof value === 'string') {
return '"' + stripQuotes(value) + '"';
} else if (value instanceof Date) {
return value.getTime();
} else if (Array.isArray(value)) {
return "[" + value.map(function (item) {
return toQueryValue(item);
}).join(',') + "]";
}
return value;
}
/**
* @global
* @namespace
* @alias Predicates
*/
module.exports = {
/**
* Convert a predicate (array of 3 elements) into a query for prismic.io (string)
*/
toQuery: function (predicate) {
var operator = stripQuotes(predicate[0]);
var path = stripQuotes(predicate[1]);
var pathArg = (path.indexOf("my.") === 0 || path.indexOf("document") === 0) ? path : '"' + path + '"';
var values = predicate.slice(2).map(toQueryValue).join(',');
return "[:d = " + operator + "(" + pathArg + (predicate.length > 2 ? ", " : "") + values + ")]";
},
/**
* Build an "at" predicate: equality of a fragment to a value.
*
* @example Predicates.at("document.type", "article")
* @param fragment {String}
* @param value {String}
* @returns {Array} an array corresponding to the predicate
*/
at: function(fragment, value) { return ["at", fragment, value]; },
/**
* Build an "not" predicate: inequality of a fragment to a value.
*
* @example Predicates.not("document.type", "article")
* @param fragment {String}
* @param value {String}
* @returns {Array} an array corresponding to the predicate
*/
not: function(fragment, value) { return ["not", fragment, value]; },
/**
* Build a "missing" predicate: documents where the requested field is empty
*
* @example Predicates.missing("my.blog-post.author")
* @param fragment {String}
* @returns {Array} an array corresponding to the predicate
*/
missing: function(fragment) { return ["missing", fragment]; },
/**
* Build a "has" predicate: documents where the requested field is defined
*
* @example Predicates.has("my.blog-post.author")
* @param fragment {String}
* @returns {Array} an array corresponding to the predicate
*/
has: function(fragment) { return ["has", fragment]; },
/**
* Build an "any" predicate: equality of a fragment to a value.
*
* @example Predicates.any("document.type", ["article", "blog-post"])
* @param fragment {String}
* @param values {Array}
* @returns {Array} an array corresponding to the predicate
*/
any: function(fragment, values) { return ["any", fragment, values]; },
/**
* Build an "in" predicate: equality of a fragment to a value.
*
* @example Predicates.in("my.product.price", [4, 5])
* @param fragment {String}
* @param values {Array}
* @returns {Array} an array corresponding to the predicate
*/
in: function(fragment, values) { return ["in", fragment, values]; },
/**
* Build a "fulltext" predicate: fulltext search in a fragment.
*
* @example Predicates.fulltext("my.article.body", "sausage"])
* @param fragment {String}
* @param value {String} the term to search
* @returns {Array} an array corresponding to the predicate
*/
fulltext: function(fragment, value) { return ["fulltext", fragment, value]; },
/**
* Build a "similar" predicate.
*
* @example Predicates.similar("UXasdFwe42D", 10)
* @param documentId {String} the document id to retrieve similar documents to.
* @param maxResults {Number} the maximum number of results to return
* @returns {Array} an array corresponding to the predicate
*/
similar: function(documentId, maxResults) { return ["similar", documentId, maxResults]; },
/**
* Build a "number.gt" predicate: documents where the fragment field is greater than the given value.
*
* @example Predicates.gt("my.product.price", 10)
* @param fragment {String} the name of the field - must be a number.
* @param value {Number} the lower bound of the predicate
* @returns {Array} an array corresponding to the predicate
*/
gt: function(fragment, value) { return ["number.gt", fragment, value]; },
/**
* Build a "number.lt" predicate: documents where the fragment field is lower than the given value.
*
* @example Predicates.lt("my.product.price", 20)
* @param fragment {String} the name of the field - must be a number.
* @param value {Number} the upper bound of the predicate
* @returns {Array} an array corresponding to the predicate
*/
lt: function(fragment, value) { return ["number.lt", fragment, value]; },
/**
* Build a "number.inRange" predicate: combination of lt and gt.
*
* @example Predicates.inRange("my.product.price", 10, 20)
* @param fragment {String} the name of the field - must be a number.
* @param before {Number}
* @param after {Number}
* @returns {Array} an array corresponding to the predicate
*/
inRange: function(fragment, before, after) { return ["number.inRange", fragment, before, after]; },
/**
* Build a "date.before" predicate: documents where the fragment field is before the given date.
*
* @example Predicates.dateBefore("my.product.releaseDate", new Date(2014, 6, 1))
* @param fragment {String} the name of the field - must be a date or timestamp field.
* @param before {Date}
* @returns {Array} an array corresponding to the predicate
*/
dateBefore: function(fragment, before) { return ["date.before", fragment, before]; },
/**
* Build a "date.after" predicate: documents where the fragment field is after the given date.
*
* @example Predicates.dateAfter("my.product.releaseDate", new Date(2014, 1, 1))
* @param fragment {String} the name of the field - must be a date or timestamp field.
* @param after {Date}
* @returns {Array} an array corresponding to the predicate
*/
dateAfter: function(fragment, after) { return ["date.after", fragment, after]; },
/**
* Build a "date.between" predicate: combination of dateBefore and dateAfter
*
* @example Predicates.dateBetween("my.product.releaseDate", new Date(2014, 1, 1), new Date(2014, 6, 1))
* @param fragment {String} the name of the field - must be a date or timestamp field.
* @param before {Date}
* @param after {Date}
* @returns {Array} an array corresponding to the predicate
*/
dateBetween: function(fragment, before, after) { return ["date.between", fragment, before, after]; },
/**
*
* @example Predicates.dayOfMonth("my.product.releaseDate", 14)
* @param fragment
* @param day {Number} between 1 and 31
* @returns {Array}
*/
dayOfMonth: function(fragment, day) { return ["date.day-of-month", fragment, day]; },
/**
*
* @example Predicates.dayOfMonthAfter("my.product.releaseDate", 14)
* @param fragment
* @param day {Number} between 1 and 31
* @returns {Array}
*/
dayOfMonthAfter: function(fragment, day) { return ["date.day-of-month-after", fragment, day]; },
/**
*
* @example Predicates.dayOfMonthBefore("my.product.releaseDate", 14)
* @param fragment
* @param day {Number} between 1 and 31
* @returns {Array}
*/
dayOfMonthBefore: function(fragment, day) { return ["date.day-of-month-before", fragment, day]; },
/**
*
* @example Predicates.dayOfWeek("my.product.releaseDate", 14)
* @param fragment
* @param day {Number|String} Number between 1 and 7 or string between "Monday" and "Sunday"
* @returns {Array}
*/
dayOfWeek: function(fragment, day) { return ["date.day-of-week", fragment, day]; },
/**
*
* @example Predicates.dayOfWeekAfter("my.product.releaseDate", "Wednesday")
* @param fragment
* @param day {Number|String} Number between 1 and 7 or string between "Monday" and "Sunday"
* @returns {Array}
*/
dayOfWeekAfter: function(fragment, day) { return ["date.day-of-week-after", fragment, day]; },
/**
*
* @example Predicates.dayOfWeekBefore("my.product.releaseDate", "Wednesday")
* @param fragment
* @param day {Number|String} Number between 1 and 7 or string between "Monday" and "Sunday"
* @returns {Array}
*/
dayOfWeekBefore: function(fragment, day) { return ["date.day-of-week-before", fragment, day]; },
/**
*
* @example Predicates.month("my.product.releaseDate", "June")
* @param fragment
* @param month {Number|String} Number between 1 and 12 or string between "January" and "December"
* @returns {Array}
*/
month: function(fragment, month) { return ["date.month", fragment, month]; },
/**
*
* @example Predicates.monthBefore("my.product.releaseDate", "June")
* @param fragment
* @param month {Number|String} Number between 1 and 12 or string between "January" and "December"
* @returns {Array}
*/
monthBefore: function(fragment, month) { return ["date.month-before", fragment, month]; },
/**
*
* @example Predicates.monthAfter("my.product.releaseDate", "June")
* @param fragment
* @param month {Number|String} Number between 1 and 12 or string between "January" and "December"
* @returns {Array}
* @returns {Array}
*/
monthAfter: function(fragment, month) { return ["date.month-after", fragment, month]; },
/**
*
* @example Predicates.year("my.product.releaseDate", 2014)
* @param fragment
* @param year {Number}
* @returns {Array}
*/
year: function(fragment, year) { return ["date.year", fragment, year]; },
/**
*
* @example Predicates.hour("my.product.releaseDate", 12)
* @param fragment
* @param hour {Number}
* @returns {Array}
*/
hour: function(fragment, hour) { return ["date.hour", fragment, hour]; },
/**
*
* @example Predicates.hourBefore("my.product.releaseDate", 12)
* @param fragment
* @param hour {Number}
* @returns {Array}
*/
hourBefore: function(fragment, hour) { return ["date.hour-before", fragment, hour]; },
/**
*
* @example Predicates.hourAfter("my.product.releaseDate", 12)
* @param fragment
* @param hour {Number}
* @returns {Array}
*/
hourAfter: function(fragment, hour) { return ["date.hour-after", fragment, hour]; },
/**
*
* @example Predicates.near("my.store.location", 48.8768767, 2.3338802, 10)
* @param fragment
* @param latitude {Number}
* @param longitude {Number}
* @param radius {Number} in kilometers
* @returns {Array}
*/
near: function(fragment, latitude, longitude, radius) { return ["geopoint.near", fragment, latitude, longitude, radius]; }
};
</code></pre>
</article>
</section>
</div>
<nav>
<h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Api.html">Api</a></li><li><a href="Doc.html">Doc</a></li><li><a href="Experiments.html">Experiments</a></li><li><a href="Fragments_Color.html">Fragments:Color</a></li><li><a href="Fragments_CompositeSlice.html">Fragments:CompositeSlice</a></li><li><a href="Fragments_Date.html">Fragments:Date</a></li><li><a href="Fragments_DocumentLink.html">Fragments:DocumentLink</a></li><li><a href="Fragments_Embed.html">Fragments:Embed</a></li><li><a href="Fragments_FileLink.html">Fragments:FileLink</a></li><li><a href="Fragments_GeoPoint.html">Fragments:GeoPoint</a></li><li><a href="Fragments_Group.html">Fragments:Group</a></li><li><a href="Fragments_ImageEl.html">Fragments:ImageEl</a></li><li><a href="Fragments_ImageLink.html">Fragments:ImageLink</a></li><li><a href="Fragments_ImageView.html">Fragments:ImageView</a></li><li><a href="Fragments_Num.html">Fragments:Num</a></li><li><a href="Fragments_Select.html">Fragments:Select</a></li><li><a href="Fragments_Separator.html">Fragments:Separator</a></li><li><a href="Fragments_SimpleSlice.html">Fragments:SimpleSlice</a></li><li><a href="Fragments_SliceZone.html">Fragments:SliceZone</a></li><li><a href="Fragments_StructuredText.html">Fragments:StructuredText</a></li><li><a href="Fragments_Text.html">Fragments:Text</a></li><li><a href="Fragments_Timestamp.html">Fragments:Timestamp</a></li><li><a href="Fragments_WebLink.html">Fragments:WebLink</a></li><li><a href="Ref.html">Ref</a></li><li><a href="Response.html">Response</a></li><li><a href="SearchForm.html">SearchForm</a></li><li><a href="WithFragments.html">WithFragments</a></li></ul><h3>Namespaces</h3><ul><li><a href="Predicates.html">Predicates</a></li></ul><h3>Global</h3><ul><li><a href="global.html#ApiCache">ApiCache</a></li><li><a href="global.html#data">data</a></li><li><a href="global.html#fragments">fragments</a></li><li><a href="global.html#insertSpans">insertSpans</a></li><li><a href="global.html#LRUCache">LRUCache</a></li><li><a href="global.html#parseDoc">parseDoc</a></li></ul>
</nav>
<br class="clear">
<footer>
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Fri Apr 28 2017 17:29:54 GMT+0200 (CEST)
</footer>
<script> prettyPrint(); </script>
<script src="scripts/linenumber.js"> </script>
</body>
</html>