ejs.version-Version.html 6.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <title>Class Version</title>
  5. <link rel="stylesheet" type="text/css" href="doc.css" />
  6. </head>
  7. <body>
  8. <div class='body'>
  9. <div class="content">
  10. <a name='top'></a>
  11. <h1 class='className'>Version</h1>
  12. <div class='classBlock'>
  13. <table class='classHead' title='Version'>
  14. <tr><td><strong>Module</strong></td><td>ejs.version</td></tr>
  15. <tr><td><strong>Definition</strong></td><td> class Version</td></tr>
  16. <tr><td><strong>Inheritance</strong></td><td>Version <img src='images/inherit.gif' alt='inherit'/> <a href='Object.html'>Object</a><tr><td><strong>Stability</strong></td><td>Prototype.</td></tr>
  17. </td></tr>
  18. </table>
  19. <p class='classBrief'>Version class supporting Semantic Versioning 2.0.0.</p>
  20. </div>
  21. <hr />
  22. <a name='Properties'></a>
  23. <h2 class='classSection'>Properties</h2>
  24. <table class='itemTable' title='properties'>
  25. <tr><th>Qualifiers</th><th>Property</th><th>Type</th><th width='95%'>Description</th></tr>
  26. <a name='compatible'></a>
  27. <tr><td nowrap align='center'> get </td><td>compatible</td><td>&nbsp;</td><td>The major.minor API compatible version number. </td></tr>
  28. <a name='debug'></a>
  29. <tr><td nowrap align='center'> get </td><td>debug</td><td><a href='Boolean.html'>Boolean</a></td><td>The version is a pre-release version
  30. This may be due to the version having a pre-release suffix, or if not a pure SemVer version,
  31. it may have non-number components that indicate a pre-release. </td></tr>
  32. <a name='major'></a>
  33. <tr><td nowrap align='center'> get </td><td>major</td><td>&nbsp;</td><td>The major release number portion of the version
  34. 8. </td></tr>
  35. <a name='minor'></a>
  36. <tr><td nowrap align='center'> get </td><td>minor</td><td>&nbsp;</td><td>The minor release number portion of the version
  37. 8. </td></tr>
  38. <a name='number'></a>
  39. <tr><td nowrap align='center'> get </td><td>number</td><td>&nbsp;</td><td>The version as a single number. </td></tr>
  40. <a name='patch'></a>
  41. <tr><td nowrap align='center'> get </td><td>patch</td><td>&nbsp;</td><td>The minor release number portion of the version
  42. 8. </td></tr>
  43. <a name='pre'></a>
  44. <tr><td nowrap align='center'> get </td><td>pre</td><td>&nbsp;</td><td>The pre-release portion of the version. </td></tr>
  45. <a name='valid'></a>
  46. <tr><td nowrap align='center'> get </td><td>valid</td><td>&nbsp;</td><td>Test if the constructed version is valid. </td></tr>
  47. <a name='version'></a>
  48. <tr><td nowrap align='center'> get </td><td>version</td><td>&nbsp;</td><td>The public portion of the version without any prereleases qualification
  49. 8. </td></tr>
  50. </table>
  51. <p class='inheritedLink'><a href='Object.html#Properties'><i>Inherited Properties</i></a></p>
  52. <hr />
  53. <a name='ClassMethods'></a>
  54. <h2 class='classSection'>Version Class Methods</h2>
  55. <table class='apiIndex' title='methods'>
  56. <tr><th>Qualifiers</th><th width='95%'>Method</th></tr>
  57. <tr class='apiDef'><td class='apiType'> static </td><td><a href='#sort'><b>sort</b></a>(versions, direction = 1): <a href='Array.html'>Array</a></tr><tr class='apiBrief'><td>&nbsp;</td><td>Sort an array of versions.</td></tr>
  58. </table>
  59. <p class='inheritedLink'><a href='Object.html#InstanceMethods'><i>Inherited Methods</i></a></p>
  60. <hr />
  61. <a name='InstanceMethods'></a>
  62. <h2 class='classSection'>Version Instance Methods</h2>
  63. <table class='apiIndex' title='methods'>
  64. <tr><th>Qualifiers</th><th width='95%'>Method</th></tr>
  65. <tr class='apiDef'><td class='apiType'></td><td><a href='#Version'><b>Version</b></a>(version: <a href='String.html'>String</a>)</tr><tr class='apiBrief'><td>&nbsp;</td><td>Create and parse a version
  66. Use valid() to test if the version string was a valid SemVer version.</td></tr>
  67. <tr class='apiDef'><td class='apiType'> </td><td><a href='#acceptable'><b>acceptable</b></a>(criteria): <a href='Boolean.html'>Boolean</a></tr><tr class='apiBrief'><td>&nbsp;</td><td>Test if the version is acceptable based on the supplied critera.</td></tr>
  68. <tr class='apiDef'><td class='apiType'> </td><td><a href='#same'><b>same</b></a>(other: <a href='String.html'>String</a>)</tr><tr class='apiBrief'><td>&nbsp;</td><td>Compare versions.</td></tr>
  69. <tr class='apiDef'><td class='apiType'> override </td><td><a href='#toString'><b>toString</b></a>()</tr><tr class='apiBrief'><td>&nbsp;</td><td>null</td></tr>
  70. </table>
  71. <p class='inheritedLink'><a href='Object.html#InstanceMethods'><i>Inherited Methods</i></a></p>
  72. <hr />
  73. <h2>Method Detail</h2>
  74. <a name='Version'></a>
  75. <div class='api'>
  76. <div class='apiSig'> ejs.version Version(version: <a href='String.html'>String</a>)
  77. </div>
  78. <div class='apiDetail'>
  79. <dl><dt>Description</dt></dd><dd>Create and parse a version
  80. Use valid() to test if the version string was a valid SemVer version. </dd></dl>
  81. </div>
  82. </div>
  83. <hr />
  84. <a name='acceptable'></a>
  85. <div class='api'>
  86. <div class='apiSig'> acceptable(criteria): <a href='Boolean.html'>Boolean</a>
  87. </div>
  88. <div class='apiDetail'>
  89. <dl><dt>Description</dt></dd><dd>Test if the version is acceptable based on the supplied critera. </dd></dl>
  90. <dl><dt>Parameters</dt>
  91. <dd><table class='parameters' title='parameters'>
  92. <tr class='param'><td class='param'>criteria </td><td>The acceptable formats for criteria are: <pre> VER Allows prereleases ^ VER Same as >=1.2.3 <2.0.0 (does not allow prereleases) ~ VER Same as >=1.2.3 <2.0.0 (allows prereleases) 1.2.X Any version starting with 1.2 (allows prereleases) [>, >=, <, <=, ==, !=] VER EXPR || EXPR ... EXPR && EXPR ... EXPR EXPR ... </pre></td></tr></table></dd>
  93. </dl><dl><dt>Returns</dt>
  94. <dd>True if the version is acceptable.</dd></dl>
  95. </div>
  96. </div>
  97. <hr />
  98. <a name='same'></a>
  99. <div class='api'>
  100. <div class='apiSig'> same(other: <a href='String.html'>String</a>)
  101. </div>
  102. <div class='apiDetail'>
  103. <dl><dt>Description</dt></dd><dd>Compare versions. </dd></dl>
  104. <dl><dt>Parameters</dt>
  105. <dd><table class='parameters' title='parameters'>
  106. <tr class='param'><td class='param'>other: <a href='String.html'>String</a> </td><td>Other version to compare with this one Can be a version or a string.</td></tr></table></dd>
  107. </dl><dl><dt>Returns</dt>
  108. <dd>True if the versions are identical.</dd></dl>
  109. </div>
  110. </div>
  111. <hr />
  112. <a name='sort'></a>
  113. <div class='api'>
  114. <div class='apiSig'>static sort(versions, direction = 1): <a href='Array.html'>Array</a>
  115. </div>
  116. <div class='apiDetail'>
  117. <dl><dt>Description</dt></dd><dd>Sort an array of versions. The version strings can be pathnames where the basename is the version.</dd></dl>
  118. <dl><dt>Parameters</dt>
  119. <dd><table class='parameters' title='parameters'>
  120. <tr class='param'><td class='param'>direction </td><td>null [default: 1]</td></tr></table></dd>
  121. </dl></div>
  122. </div>
  123. <hr />
  124. <div class="terms">
  125. <p class="terms">
  126. <a href="https://www.embedthis.com/"> Embedthis Software LLC, 2003-2014. All rights reserved. Embedthis is a trademark of Embedthis Software LLC.</a>
  127. </p>
  128. </div></div>
  129. </div>
  130. </body>
  131. </html>