grpc.Client.html 51 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width">
  6. <title>Documentation Class: Client</title>
  7. <!--[if lt IE 9]>
  8. <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
  9. <![endif]-->
  10. <link type="text/css" rel="stylesheet" href="styles/sunlight.default.css">
  11. <link type="text/css" rel="stylesheet" href="styles/site.simplex.css">
  12. </head>
  13. <body>
  14. <div class="navbar navbar-default navbar-fixed-top ">
  15. <div class="container">
  16. <div class="navbar-header">
  17. <a class="navbar-brand" href="index.html">Documentation</a>
  18. <button class="navbar-toggle" type="button" data-toggle="collapse" data-target="#topNavigation">
  19. <span class="icon-bar"></span>
  20. <span class="icon-bar"></span>
  21. <span class="icon-bar"></span>
  22. </button>
  23. </div>
  24. <div class="navbar-collapse collapse" id="topNavigation">
  25. <ul class="nav navbar-nav">
  26. <li class="dropdown">
  27. <a href="namespaces.list.html" class="dropdown-toggle" data-toggle="dropdown">Namespaces<b class="caret"></b></a>
  28. <ul class="dropdown-menu ">
  29. <li><a href="grpc.html">grpc</a></li><li><a href="grpc.credentials.html">grpc.credentials</a></li>
  30. </ul>
  31. </li>
  32. <li class="dropdown">
  33. <a href="modules.list.html" class="dropdown-toggle" data-toggle="dropdown">Modules<b class="caret"></b></a>
  34. <ul class="dropdown-menu ">
  35. <li><a href="module-src_client_interceptors.html">src/client_interceptors</a></li>
  36. </ul>
  37. </li>
  38. <li class="dropdown">
  39. <a href="classes.list.html" class="dropdown-toggle" data-toggle="dropdown">Classes<b class="caret"></b></a>
  40. <ul class="dropdown-menu ">
  41. <li><a href="grpc.Channel.html">grpc.Channel</a></li><li><a href="grpc.Client.html">grpc.Client</a></li><li><a href="grpc.credentials-CallCredentials.html">grpc.credentials~CallCredentials</a></li><li><a href="grpc.credentials-ChannelCredentials.html">grpc.credentials~ChannelCredentials</a></li><li><a href="grpc.Metadata.html">grpc.Metadata</a></li><li><a href="grpc.Server.html">grpc.Server</a></li><li><a href="grpc.ServerCredentials.html">grpc.ServerCredentials</a></li><li><a href="grpc-Call.html">grpc~Call</a></li><li><a href="grpc-ClientDuplexStream.html">grpc~ClientDuplexStream</a></li><li><a href="grpc-ClientReadableStream.html">grpc~ClientReadableStream</a></li><li><a href="grpc-ClientUnaryCall.html">grpc~ClientUnaryCall</a></li><li><a href="grpc-ClientWritableStream.html">grpc~ClientWritableStream</a></li><li><a href="grpc-ServerDuplexStream.html">grpc~ServerDuplexStream</a></li><li><a href="grpc-ServerReadableStream.html">grpc~ServerReadableStream</a></li><li><a href="grpc-ServerUnaryCall.html">grpc~ServerUnaryCall</a></li><li><a href="grpc-ServerWritableStream.html">grpc~ServerWritableStream</a></li><li><a href="module-src_client_interceptors-EndListener.html">src/client_interceptors~EndListener</a></li><li><a href="module-src_client_interceptors-InterceptingCall.html">src/client_interceptors~InterceptingCall</a></li><li><a href="module-src_client_interceptors-InterceptingListener.html">src/client_interceptors~InterceptingListener</a></li><li><a href="module-src_client_interceptors-InterceptorConfigurationError.html">src/client_interceptors~InterceptorConfigurationError</a></li><li><a href="module-src_client_interceptors-ListenerBuilder.html">src/client_interceptors~ListenerBuilder</a></li><li><a href="module-src_client_interceptors-RequesterBuilder.html">src/client_interceptors~RequesterBuilder</a></li><li><a href="module-src_client_interceptors-StatusBuilder.html">src/client_interceptors~StatusBuilder</a></li>
  42. </ul>
  43. </li>
  44. <li class="dropdown">
  45. <a href="events.list.html" class="dropdown-toggle" data-toggle="dropdown">Events<b class="caret"></b></a>
  46. <ul class="dropdown-menu ">
  47. <li><a href="grpc-ClientDuplexStream.html#event:metadata">grpc~ClientDuplexStream#metadata</a></li><li><a href="grpc-ClientDuplexStream.html#event:status">grpc~ClientDuplexStream#status</a></li><li><a href="grpc-ClientReadableStream.html#event:metadata">grpc~ClientReadableStream#metadata</a></li><li><a href="grpc-ClientReadableStream.html#event:status">grpc~ClientReadableStream#status</a></li><li><a href="grpc-ClientUnaryCall.html#event:metadata">grpc~ClientUnaryCall#event:metadata</a></li><li><a href="grpc-ClientUnaryCall.html#event:status">grpc~ClientUnaryCall#event:status</a></li><li><a href="grpc-ClientWritableStream.html#event:metadata">grpc~ClientWritableStream#metadata</a></li><li><a href="grpc-ClientWritableStream.html#event:status">grpc~ClientWritableStream#status</a></li><li><a href="grpc-ServerDuplexStream.html#~event:cancelled">grpc~ServerDuplexStream~event:cancelled</a></li><li><a href="grpc-ServerReadableStream.html#~event:cancelled">grpc~ServerReadableStream~event:cancelled</a></li><li><a href="grpc-ServerUnaryCall.html#~event:cancelled">grpc~ServerUnaryCall~event:cancelled</a></li><li><a href="grpc-ServerWritableStream.html#~event:cancelled">grpc~ServerWritableStream~event:cancelled</a></li>
  48. </ul>
  49. </li>
  50. <li class="dropdown">
  51. <a href="global.html" class="dropdown-toggle" data-toggle="dropdown">Global<b class="caret"></b></a>
  52. <ul class="dropdown-menu ">
  53. <li><a href="global.html#CancelRequester">CancelRequester</a></li><li><a href="global.html#CloseRequester">CloseRequester</a></li><li><a href="global.html#createStatusError">createStatusError</a></li><li><a href="global.html#getClientInterceptors">getClientInterceptors</a></li><li><a href="global.html#getMethodType">getMethodType</a></li><li><a href="global.html#GetPeerRequester">GetPeerRequester</a></li><li><a href="global.html#Interceptor">Interceptor</a></li><li><a href="global.html#InterceptorProvider">InterceptorProvider</a></li><li><a href="global.html#loadPackageDefinition">loadPackageDefinition</a></li><li><a href="global.html#MessageListener">MessageListener</a></li><li><a href="global.html#MessageRequester">MessageRequester</a></li><li><a href="global.html#MetadataListener">MetadataListener</a></li><li><a href="global.html#MetadataRequester">MetadataRequester</a></li><li><a href="global.html#NextCall">NextCall</a></li><li><a href="global.html#StatusListener">StatusListener</a></li>
  54. </ul>
  55. </li>
  56. <li class="dropdown">
  57. <a href="externals.list.html" class="dropdown-toggle" data-toggle="dropdown">Externals<b class="caret"></b></a>
  58. <ul class="dropdown-menu ">
  59. <li><a href="external-Duplex.html">Duplex</a></li><li><a href="external-EventEmitter.html">EventEmitter</a></li><li><a href="external-GoogleCredential.html">GoogleCredential</a></li><li><a href="external-Readable.html">Readable</a></li><li><a href="external-Writable.html">Writable</a></li>
  60. </ul>
  61. </li>
  62. </ul>
  63. <div class="col-sm-3 col-md-3">
  64. <form class="navbar-form" role="search">
  65. <div class="input-group">
  66. <input type="text" class="form-control" placeholder="Search" name="q" id="search-input">
  67. <div class="input-group-btn">
  68. <button class="btn btn-default" id="search-submit"><i class="glyphicon glyphicon-search"></i></button>
  69. </div>
  70. </div>
  71. </form>
  72. </div>
  73. </div>
  74. </div>
  75. </div>
  76. <div class="container" id="toc-content">
  77. <div class="row">
  78. <div class="col-md-8">
  79. <div id="main">
  80. <h1 class="page-title">Class: Client</h1>
  81. <section>
  82. <header>
  83. <h2>
  84. <span class="ancestors"><a href="grpc.html">grpc</a>.</span>
  85. Client
  86. </h2>
  87. </header>
  88. <article>
  89. <div class="container-overview">
  90. <hr>
  91. <dt>
  92. <h4 class="name" id="Client"><span class="type-signature"></span>new Client(address, credentials, options)</h4>
  93. </dt>
  94. <dd>
  95. <div class="description">
  96. <p>A generic gRPC client. Primarily useful as a base class for generated clients</p>
  97. </div>
  98. <h5>Parameters:</h5>
  99. <table class="params table table-striped">
  100. <thead>
  101. <tr>
  102. <th>Name</th>
  103. <th>Type</th>
  104. <th class="last">Description</th>
  105. </tr>
  106. </thead>
  107. <tbody>
  108. <tr>
  109. <td class="name"><code>address</code></td>
  110. <td class="type">
  111. <span class="param-type">string</span>
  112. </td>
  113. <td class="description last"><p>Server address to connect to</p></td>
  114. </tr>
  115. <tr>
  116. <td class="name"><code>credentials</code></td>
  117. <td class="type">
  118. <span class="param-type"><a href="grpc.credentials-ChannelCredentials.html">grpc.credentials~ChannelCredentials</a></span>
  119. </td>
  120. <td class="description last"><p>Credentials to use
  121. to connect to the server</p></td>
  122. </tr>
  123. <tr>
  124. <td class="name"><code>options</code></td>
  125. <td class="type">
  126. <span class="param-type">Object</span>
  127. </td>
  128. <td class="description last"><p>Options to apply to channel creation. Any of
  129. <a href="https://grpc.github.io/grpc/core/group__grpc__arg__keys.html">the channel arguments</a>
  130. can be used here in addition to specific client options.</p>
  131. <h6 class="method-params-label method-subparams-label">Properties</h6>
  132. <table class="params table table-striped">
  133. <thead>
  134. <tr>
  135. <th>Name</th>
  136. <th>Type</th>
  137. <th>Argument</th>
  138. <th class="last">Description</th>
  139. </tr>
  140. </thead>
  141. <tbody>
  142. <tr>
  143. <td class="name"><code>interceptors</code></td>
  144. <td class="type">
  145. <span class="param-type">Array.&lt;grpc~Interceptor></span>
  146. </td>
  147. <td class="attributes">
  148. &lt;optional><br>
  149. </td>
  150. <td class="description last"><p>Interceptors to apply to each request</p></td>
  151. </tr>
  152. <tr>
  153. <td class="name"><code>interceptor_providers</code></td>
  154. <td class="type">
  155. <span class="param-type">Array.&lt;grpc~InterceptorProvider></span>
  156. </td>
  157. <td class="attributes">
  158. &lt;optional><br>
  159. </td>
  160. <td class="description last"><p>Interceptor providers
  161. to apply interceptors to each request depending on the method definition. At most
  162. one of the interceptors and interceptor_providers options may be set.</p></td>
  163. </tr>
  164. <tr>
  165. <td class="name"><code>callInvocationTransformer</code></td>
  166. <td class="type">
  167. <span class="param-type"><a href="grpc.Client.html#~callInvocationTransformer">grpc.Client~callInvocationTransformer</a></span>
  168. </td>
  169. <td class="attributes">
  170. &lt;optional><br>
  171. </td>
  172. <td class="description last"></td>
  173. </tr>
  174. <tr>
  175. <td class="name"><code>channelOverride</code></td>
  176. <td class="type">
  177. <span class="param-type"><a href="grpc.Channel.html">grpc.Channel</a></span>
  178. </td>
  179. <td class="attributes">
  180. &lt;optional><br>
  181. </td>
  182. <td class="description last"><p>Channel to use instead of constructing a new one.
  183. If set, the address, credentials, channel arguments options, and channelFactoryOverride
  184. option will all be ignored.</p></td>
  185. </tr>
  186. <tr>
  187. <td class="name"><code>channelFactoryOverride</code></td>
  188. <td class="type">
  189. <span class="param-type"><a href="grpc.Client.html#~channelFactory">grpc.Client~channelFactory</a></span>
  190. </td>
  191. <td class="attributes">
  192. </td>
  193. <td class="description last"><p>Function to use instead of
  194. the Channel constructor when creating the Client's channel.</p></td>
  195. </tr>
  196. </tbody>
  197. </table>
  198. </td>
  199. </tr>
  200. </tbody>
  201. </table>
  202. <dl class="details">
  203. </dl>
  204. </dd>
  205. </div>
  206. <h3 class="subsection-title">Methods</h3>
  207. <dl>
  208. <hr>
  209. <dt>
  210. <h4 class="name" id="close"><span class="type-signature"></span>close()</h4>
  211. </dt>
  212. <dd>
  213. <div class="description">
  214. <p>Close this client.</p>
  215. </div>
  216. <dl class="details">
  217. </dl>
  218. </dd>
  219. <hr>
  220. <dt>
  221. <h4 class="name" id="getChannel"><span class="type-signature"></span>getChannel()</h4>
  222. </dt>
  223. <dd>
  224. <div class="description">
  225. <p>Return the underlying channel object for the specified client</p>
  226. </div>
  227. <dl class="details">
  228. </dl>
  229. <h5>Returns:</h5>
  230. <div class="param-desc">
  231. <p>The channel</p>
  232. </div>
  233. <dl>
  234. <dt>
  235. Type
  236. </dt>
  237. <dd>
  238. <span class="param-type">Channel</span>
  239. </dd>
  240. </dl>
  241. </dd>
  242. <hr>
  243. <dt>
  244. <h4 class="name" id="makeBidiStreamRequest"><span class="type-signature"></span>makeBidiStreamRequest(path, serialize, deserialize [, metadata] [, options])</h4>
  245. </dt>
  246. <dd>
  247. <div class="description">
  248. <p>Make a bidirectional stream request with this method on the given channel.</p>
  249. </div>
  250. <h5>Parameters:</h5>
  251. <table class="params table table-striped">
  252. <thead>
  253. <tr>
  254. <th>Name</th>
  255. <th>Type</th>
  256. <th>Argument</th>
  257. <th class="last">Description</th>
  258. </tr>
  259. </thead>
  260. <tbody>
  261. <tr>
  262. <td class="name"><code>path</code></td>
  263. <td class="type">
  264. <span class="param-type">string</span>
  265. </td>
  266. <td class="attributes">
  267. </td>
  268. <td class="description last"><p>The path of the method to request</p></td>
  269. </tr>
  270. <tr>
  271. <td class="name"><code>serialize</code></td>
  272. <td class="type">
  273. <span class="param-type"><a href="grpc.html#~serialize">grpc~serialize</a></span>
  274. </td>
  275. <td class="attributes">
  276. </td>
  277. <td class="description last"><p>The serialization function for inputs</p></td>
  278. </tr>
  279. <tr>
  280. <td class="name"><code>deserialize</code></td>
  281. <td class="type">
  282. <span class="param-type"><a href="grpc.html#~deserialize">grpc~deserialize</a></span>
  283. </td>
  284. <td class="attributes">
  285. </td>
  286. <td class="description last"><p>The deserialization
  287. function for outputs</p></td>
  288. </tr>
  289. <tr>
  290. <td class="name"><code>metadata</code></td>
  291. <td class="type">
  292. <span class="param-type"><a href="grpc.Metadata.html">grpc.Metadata</a></span>
  293. </td>
  294. <td class="attributes">
  295. &lt;optional><br>
  296. </td>
  297. <td class="description last"><p>Array of metadata key/value
  298. pairs to add to the call</p></td>
  299. </tr>
  300. <tr>
  301. <td class="name"><code>options</code></td>
  302. <td class="type">
  303. <span class="param-type"><a href="grpc.Client.html#~CallOptions">grpc.Client~CallOptions</a></span>
  304. </td>
  305. <td class="attributes">
  306. &lt;optional><br>
  307. </td>
  308. <td class="description last"><p>Options map</p></td>
  309. </tr>
  310. </tbody>
  311. </table>
  312. <dl class="details">
  313. </dl>
  314. <h5>Returns:</h5>
  315. <div class="param-desc">
  316. <p>An event emitter for stream related events</p>
  317. </div>
  318. <dl>
  319. <dt>
  320. Type
  321. </dt>
  322. <dd>
  323. <span class="param-type"><a href="grpc-ClientDuplexStream.html">grpc~ClientDuplexStream</a></span>
  324. </dd>
  325. </dl>
  326. </dd>
  327. <hr>
  328. <dt>
  329. <h4 class="name" id="makeClientStreamRequest"><span class="type-signature"></span>makeClientStreamRequest(path, serialize, deserialize [, metadata] [, options], callback)</h4>
  330. </dt>
  331. <dd>
  332. <div class="description">
  333. <p>Make a client stream request to the given method, using the given serialize
  334. and deserialize functions, with the given argument.</p>
  335. </div>
  336. <h5>Parameters:</h5>
  337. <table class="params table table-striped">
  338. <thead>
  339. <tr>
  340. <th>Name</th>
  341. <th>Type</th>
  342. <th>Argument</th>
  343. <th class="last">Description</th>
  344. </tr>
  345. </thead>
  346. <tbody>
  347. <tr>
  348. <td class="name"><code>path</code></td>
  349. <td class="type">
  350. <span class="param-type">string</span>
  351. </td>
  352. <td class="attributes">
  353. </td>
  354. <td class="description last"><p>The path of the method to request</p></td>
  355. </tr>
  356. <tr>
  357. <td class="name"><code>serialize</code></td>
  358. <td class="type">
  359. <span class="param-type"><a href="grpc.html#~serialize">grpc~serialize</a></span>
  360. </td>
  361. <td class="attributes">
  362. </td>
  363. <td class="description last"><p>The serialization function for
  364. inputs</p></td>
  365. </tr>
  366. <tr>
  367. <td class="name"><code>deserialize</code></td>
  368. <td class="type">
  369. <span class="param-type"><a href="grpc.html#~deserialize">grpc~deserialize</a></span>
  370. </td>
  371. <td class="attributes">
  372. </td>
  373. <td class="description last"><p>The deserialization
  374. function for outputs</p></td>
  375. </tr>
  376. <tr>
  377. <td class="name"><code>metadata</code></td>
  378. <td class="type">
  379. <span class="param-type"><a href="grpc.Metadata.html">grpc.Metadata</a></span>
  380. </td>
  381. <td class="attributes">
  382. &lt;optional><br>
  383. </td>
  384. <td class="description last"><p>Array of metadata key/value pairs to add to
  385. the call</p></td>
  386. </tr>
  387. <tr>
  388. <td class="name"><code>options</code></td>
  389. <td class="type">
  390. <span class="param-type"><a href="grpc.Client.html#~CallOptions">grpc.Client~CallOptions</a></span>
  391. </td>
  392. <td class="attributes">
  393. &lt;optional><br>
  394. </td>
  395. <td class="description last"><p>Options map</p></td>
  396. </tr>
  397. <tr>
  398. <td class="name"><code>callback</code></td>
  399. <td class="type">
  400. <span class="param-type"><a href="grpc.Client.html#~requestCallback">grpc.Client~requestCallback</a></span>
  401. </td>
  402. <td class="attributes">
  403. </td>
  404. <td class="description last"><p>The callback for when the
  405. response is received</p></td>
  406. </tr>
  407. </tbody>
  408. </table>
  409. <dl class="details">
  410. </dl>
  411. <h5>Returns:</h5>
  412. <div class="param-desc">
  413. <p>An event emitter for stream related
  414. events</p>
  415. </div>
  416. <dl>
  417. <dt>
  418. Type
  419. </dt>
  420. <dd>
  421. <span class="param-type"><a href="grpc-ClientWritableStream.html">grpc~ClientWritableStream</a></span>
  422. </dd>
  423. </dl>
  424. </dd>
  425. <hr>
  426. <dt>
  427. <h4 class="name" id="makeServerStreamRequest"><span class="type-signature"></span>makeServerStreamRequest(path, serialize, deserialize, argument [, metadata] [, options])</h4>
  428. </dt>
  429. <dd>
  430. <div class="description">
  431. <p>Make a server stream request to the given method, with the given serialize
  432. and deserialize function, using the given argument</p>
  433. </div>
  434. <h5>Parameters:</h5>
  435. <table class="params table table-striped">
  436. <thead>
  437. <tr>
  438. <th>Name</th>
  439. <th>Type</th>
  440. <th>Argument</th>
  441. <th class="last">Description</th>
  442. </tr>
  443. </thead>
  444. <tbody>
  445. <tr>
  446. <td class="name"><code>path</code></td>
  447. <td class="type">
  448. <span class="param-type">string</span>
  449. </td>
  450. <td class="attributes">
  451. </td>
  452. <td class="description last"><p>The path of the method to request</p></td>
  453. </tr>
  454. <tr>
  455. <td class="name"><code>serialize</code></td>
  456. <td class="type">
  457. <span class="param-type"><a href="grpc.html#~serialize">grpc~serialize</a></span>
  458. </td>
  459. <td class="attributes">
  460. </td>
  461. <td class="description last"><p>The serialization function for inputs</p></td>
  462. </tr>
  463. <tr>
  464. <td class="name"><code>deserialize</code></td>
  465. <td class="type">
  466. <span class="param-type"><a href="grpc.html#~deserialize">grpc~deserialize</a></span>
  467. </td>
  468. <td class="attributes">
  469. </td>
  470. <td class="description last"><p>The deserialization
  471. function for outputs</p></td>
  472. </tr>
  473. <tr>
  474. <td class="name"><code>argument</code></td>
  475. <td class="type">
  476. <span class="param-type">*</span>
  477. </td>
  478. <td class="attributes">
  479. </td>
  480. <td class="description last"><p>The argument to the call. Should be serializable with
  481. serialize</p></td>
  482. </tr>
  483. <tr>
  484. <td class="name"><code>metadata</code></td>
  485. <td class="type">
  486. <span class="param-type"><a href="grpc.Metadata.html">grpc.Metadata</a></span>
  487. </td>
  488. <td class="attributes">
  489. &lt;optional><br>
  490. </td>
  491. <td class="description last"><p>Array of metadata key/value pairs to add to
  492. the call</p></td>
  493. </tr>
  494. <tr>
  495. <td class="name"><code>options</code></td>
  496. <td class="type">
  497. <span class="param-type"><a href="grpc.Client.html#~CallOptions">grpc.Client~CallOptions</a></span>
  498. </td>
  499. <td class="attributes">
  500. &lt;optional><br>
  501. </td>
  502. <td class="description last"><p>Options map</p></td>
  503. </tr>
  504. </tbody>
  505. </table>
  506. <dl class="details">
  507. </dl>
  508. <h5>Returns:</h5>
  509. <div class="param-desc">
  510. <p>An event emitter for stream related
  511. events</p>
  512. </div>
  513. <dl>
  514. <dt>
  515. Type
  516. </dt>
  517. <dd>
  518. <span class="param-type"><a href="grpc-ClientReadableStream.html">grpc~ClientReadableStream</a></span>
  519. </dd>
  520. </dl>
  521. </dd>
  522. <hr>
  523. <dt>
  524. <h4 class="name" id="makeUnaryRequest"><span class="type-signature"></span>makeUnaryRequest(path, serialize, deserialize, argument [, metadata] [, options], callback)</h4>
  525. </dt>
  526. <dd>
  527. <div class="description">
  528. <p>Make a unary request to the given method, using the given serialize
  529. and deserialize functions, with the given argument.</p>
  530. </div>
  531. <h5>Parameters:</h5>
  532. <table class="params table table-striped">
  533. <thead>
  534. <tr>
  535. <th>Name</th>
  536. <th>Type</th>
  537. <th>Argument</th>
  538. <th class="last">Description</th>
  539. </tr>
  540. </thead>
  541. <tbody>
  542. <tr>
  543. <td class="name"><code>path</code></td>
  544. <td class="type">
  545. <span class="param-type">string</span>
  546. </td>
  547. <td class="attributes">
  548. </td>
  549. <td class="description last"><p>The path of the method to request</p></td>
  550. </tr>
  551. <tr>
  552. <td class="name"><code>serialize</code></td>
  553. <td class="type">
  554. <span class="param-type"><a href="grpc.html#~serialize">grpc~serialize</a></span>
  555. </td>
  556. <td class="attributes">
  557. </td>
  558. <td class="description last"><p>The serialization function for
  559. inputs</p></td>
  560. </tr>
  561. <tr>
  562. <td class="name"><code>deserialize</code></td>
  563. <td class="type">
  564. <span class="param-type"><a href="grpc.html#~deserialize">grpc~deserialize</a></span>
  565. </td>
  566. <td class="attributes">
  567. </td>
  568. <td class="description last"><p>The deserialization
  569. function for outputs</p></td>
  570. </tr>
  571. <tr>
  572. <td class="name"><code>argument</code></td>
  573. <td class="type">
  574. <span class="param-type">*</span>
  575. </td>
  576. <td class="attributes">
  577. </td>
  578. <td class="description last"><p>The argument to the call. Should be serializable with
  579. serialize</p></td>
  580. </tr>
  581. <tr>
  582. <td class="name"><code>metadata</code></td>
  583. <td class="type">
  584. <span class="param-type"><a href="grpc.Metadata.html">grpc.Metadata</a></span>
  585. </td>
  586. <td class="attributes">
  587. &lt;optional><br>
  588. </td>
  589. <td class="description last"><p>Metadata to add to the call</p></td>
  590. </tr>
  591. <tr>
  592. <td class="name"><code>options</code></td>
  593. <td class="type">
  594. <span class="param-type"><a href="grpc.Client.html#~CallOptions">grpc.Client~CallOptions</a></span>
  595. </td>
  596. <td class="attributes">
  597. &lt;optional><br>
  598. </td>
  599. <td class="description last"><p>Options map</p></td>
  600. </tr>
  601. <tr>
  602. <td class="name"><code>callback</code></td>
  603. <td class="type">
  604. <span class="param-type"><a href="grpc.Client.html#~requestCallback">grpc.Client~requestCallback</a></span>
  605. </td>
  606. <td class="attributes">
  607. </td>
  608. <td class="description last"><p>The callback
  609. for when the response is received</p></td>
  610. </tr>
  611. </tbody>
  612. </table>
  613. <dl class="details">
  614. </dl>
  615. <h5>Returns:</h5>
  616. <div class="param-desc">
  617. <p>An event emitter for stream related events</p>
  618. </div>
  619. <dl>
  620. <dt>
  621. Type
  622. </dt>
  623. <dd>
  624. <span class="param-type"><a href="grpc-ClientUnaryCall.html">grpc~ClientUnaryCall</a></span>
  625. </dd>
  626. </dl>
  627. </dd>
  628. <hr>
  629. <dt>
  630. <h4 class="name" id="waitForReady"><span class="type-signature"></span>waitForReady(deadline, callback)</h4>
  631. </dt>
  632. <dd>
  633. <div class="description">
  634. <p>Wait for the client to be ready. The callback will be called when the
  635. client has successfully connected to the server, and it will be called
  636. with an error if the attempt to connect to the server has unrecoverablly
  637. failed or if the deadline expires. This function will make the channel
  638. start connecting if it has not already done so.</p>
  639. </div>
  640. <h5>Parameters:</h5>
  641. <table class="params table table-striped">
  642. <thead>
  643. <tr>
  644. <th>Name</th>
  645. <th>Type</th>
  646. <th class="last">Description</th>
  647. </tr>
  648. </thead>
  649. <tbody>
  650. <tr>
  651. <td class="name"><code>deadline</code></td>
  652. <td class="type">
  653. <span class="param-type"><a href="grpc.html#~Deadline">grpc~Deadline</a></span>
  654. </td>
  655. <td class="description last"><p>When to stop waiting for a connection.</p></td>
  656. </tr>
  657. <tr>
  658. <td class="name"><code>callback</code></td>
  659. <td class="type">
  660. <span class="param-type">function</span>
  661. </td>
  662. <td class="description last"><p>The callback to call when done attempting
  663. to connect.</p></td>
  664. </tr>
  665. </tbody>
  666. </table>
  667. <dl class="details">
  668. </dl>
  669. </dd>
  670. <hr>
  671. <dt>
  672. <h4 class="name" id="~callInvocationTransformer"><span class="type-signature">&lt;inner> </span>callInvocationTransformer(callProperties)</h4>
  673. </dt>
  674. <dd>
  675. <div class="description">
  676. <p>Call invocation transformer. Has access to the full call properties before a
  677. call is processed and can modify most of those properties. Some modifications
  678. will have no effect or may cause problems.</p>
  679. </div>
  680. <h5>Parameters:</h5>
  681. <table class="params table table-striped">
  682. <thead>
  683. <tr>
  684. <th>Name</th>
  685. <th>Type</th>
  686. <th class="last">Description</th>
  687. </tr>
  688. </thead>
  689. <tbody>
  690. <tr>
  691. <td class="name"><code>callProperties</code></td>
  692. <td class="type">
  693. <span class="param-type"><a href="grpc.Client.html#~CallProperties">grpc.Client~CallProperties</a></span>
  694. </td>
  695. <td class="description last"><p>The original call properties</p></td>
  696. </tr>
  697. </tbody>
  698. </table>
  699. <dl class="details">
  700. </dl>
  701. <h5>Returns:</h5>
  702. <div class="param-desc">
  703. <p>The modified call properties.</p>
  704. </div>
  705. <dl>
  706. <dt>
  707. Type
  708. </dt>
  709. <dd>
  710. <span class="param-type"><a href="grpc.Client.html#~CallProperties">grpc.Client~CallProperties</a></span>
  711. </dd>
  712. </dl>
  713. </dd>
  714. <hr>
  715. <dt>
  716. <h4 class="name" id="~channelFactory"><span class="type-signature">&lt;inner> </span>channelFactory(target, credentials, options)</h4>
  717. </dt>
  718. <dd>
  719. <div class="description">
  720. <p>A function that functionally replaces the Channel constructor.</p>
  721. </div>
  722. <h5>Parameters:</h5>
  723. <table class="params table table-striped">
  724. <thead>
  725. <tr>
  726. <th>Name</th>
  727. <th>Type</th>
  728. <th class="last">Description</th>
  729. </tr>
  730. </thead>
  731. <tbody>
  732. <tr>
  733. <td class="name"><code>target</code></td>
  734. <td class="type">
  735. <span class="param-type">string</span>
  736. </td>
  737. <td class="description last"><p>The address of the server to connect to</p></td>
  738. </tr>
  739. <tr>
  740. <td class="name"><code>credentials</code></td>
  741. <td class="type">
  742. <span class="param-type">grpc.ChannelCredentials</span>
  743. </td>
  744. <td class="description last"><p>Channel credentials to use when connecting</p></td>
  745. </tr>
  746. <tr>
  747. <td class="name"><code>options</code></td>
  748. <td class="type">
  749. <span class="param-type"><a href="grpc.html#~ChannelOptions">grpc~ChannelOptions</a></span>
  750. </td>
  751. <td class="description last"><p>A map of channel options that will be passed to the core.
  752. The available options are listed in
  753. <a href="https://grpc.github.io/grpc/core/group__grpc__arg__keys.html">this document</a>.</p></td>
  754. </tr>
  755. </tbody>
  756. </table>
  757. <dl class="details">
  758. </dl>
  759. <h5>Returns:</h5>
  760. <div class="param-desc">
  761. <p>This can either be an actual channel object, or an object with the
  762. same API.</p>
  763. </div>
  764. <dl>
  765. <dt>
  766. Type
  767. </dt>
  768. <dd>
  769. <span class="param-type"><a href="grpc.Channel.html">grpc.Channel</a></span>
  770. </dd>
  771. </dl>
  772. </dd>
  773. </dl>
  774. <h3 class="subsection-title">Type Definitions</h3>
  775. <dl>
  776. <hr>
  777. <dt class="name" id="~Call">
  778. <h4 id="~Call">Call</h4>
  779. </dt>
  780. <dd>
  781. <div class="description">
  782. <p>Any client call type</p>
  783. </div>
  784. <h5>Type:</h5>
  785. <ul>
  786. <li>
  787. <span class="param-type"><a href="grpc-ClientUnaryCall.html">grpc~ClientUnaryCall</a></span>
  788. |
  789. <span class="param-type"><a href="grpc-ClientReadableStream.html">grpc~ClientReadableStream</a></span>
  790. |
  791. <span class="param-type"><a href="grpc-ClientWritableStream.html">grpc~ClientWritableStream</a></span>
  792. |
  793. <span class="param-type"><a href="grpc-ClientDuplexStream.html">grpc~ClientDuplexStream</a></span>
  794. </li>
  795. </ul>
  796. <dl class="details">
  797. </dl>
  798. </dd>
  799. <hr>
  800. <dt class="name" id="~CallOptions">
  801. <h4 id="~CallOptions">CallOptions</h4>
  802. </dt>
  803. <dd>
  804. <div class="description">
  805. <p>Options that can be set on a call.</p>
  806. </div>
  807. <h5>Type:</h5>
  808. <ul>
  809. <li>
  810. <span class="param-type">Object</span>
  811. </li>
  812. </ul>
  813. <dl class="details">
  814. <h5 class="subsection-title">Properties:</h5>
  815. <dl>
  816. <table class="props table table-striped">
  817. <thead>
  818. <tr>
  819. <th>Name</th>
  820. <th>Type</th>
  821. <th class="last">Description</th>
  822. </tr>
  823. </thead>
  824. <tbody>
  825. <tr>
  826. <td class="name"><code>deadline</code></td>
  827. <td class="type">
  828. <span class="param-type"><a href="grpc.html#~Deadline">grpc~Deadline</a></span>
  829. </td>
  830. <td class="description last"><p>The deadline for the entire call to
  831. complete.</p></td>
  832. </tr>
  833. <tr>
  834. <td class="name"><code>host</code></td>
  835. <td class="type">
  836. <span class="param-type">string</span>
  837. </td>
  838. <td class="description last"><p>Server hostname to set on the call. Only meaningful
  839. if different from the server address used to construct the client.</p></td>
  840. </tr>
  841. <tr>
  842. <td class="name"><code>parent</code></td>
  843. <td class="type">
  844. <span class="param-type"><a href="grpc.Client.html#~Call">grpc.Client~Call</a></span>
  845. </td>
  846. <td class="description last"><p>Parent call. Used in servers when
  847. making a call as part of the process of handling a call. Used to
  848. propagate some information automatically, as specified by
  849. propagate_flags.</p></td>
  850. </tr>
  851. <tr>
  852. <td class="name"><code>propagate_flags</code></td>
  853. <td class="type">
  854. <span class="param-type">number</span>
  855. </td>
  856. <td class="description last"><p>Indicates which properties of a parent
  857. call should propagate to this call. Bitwise combination of flags in
  858. <a href="grpc.html#.propagate">grpc.propagate</a>.</p></td>
  859. </tr>
  860. <tr>
  861. <td class="name"><code>credentials</code></td>
  862. <td class="type">
  863. <span class="param-type"><a href="grpc.credentials-CallCredentials.html">grpc.credentials~CallCredentials</a></span>
  864. </td>
  865. <td class="description last"><p>The credentials that
  866. should be used to make this particular call.</p></td>
  867. </tr>
  868. </tbody>
  869. </table>
  870. </dl>
  871. </dl>
  872. </dd>
  873. <hr>
  874. <dt class="name" id="~CallProperties">
  875. <h4 id="~CallProperties">CallProperties</h4>
  876. </dt>
  877. <dd>
  878. <div class="description">
  879. <p>Properties of a call, for use with a <a href="grpc.Client.html#~callInvocationTransformer">grpc.Client~callInvocationTransformer</a>.</p>
  880. </div>
  881. <h5>Type:</h5>
  882. <ul>
  883. <li>
  884. <span class="param-type">Object</span>
  885. </li>
  886. </ul>
  887. <dl class="details">
  888. <h5 class="subsection-title">Properties:</h5>
  889. <dl>
  890. <table class="props table table-striped">
  891. <thead>
  892. <tr>
  893. <th>Name</th>
  894. <th>Type</th>
  895. <th class="last">Description</th>
  896. </tr>
  897. </thead>
  898. <tbody>
  899. <tr>
  900. <td class="name"><code>argument</code></td>
  901. <td class="type">
  902. <span class="param-type">*</span>
  903. </td>
  904. <td class="description last"><p>The call argument. Only preset if the method is unary or server streaming.</p></td>
  905. </tr>
  906. <tr>
  907. <td class="name"><code>metadata</code></td>
  908. <td class="type">
  909. <span class="param-type"><a href="grpc.Metadata.html">grpc.Metadata</a></span>
  910. </td>
  911. <td class="description last"><p>The request metadata</p></td>
  912. </tr>
  913. <tr>
  914. <td class="name"><code>call</code></td>
  915. <td class="type">
  916. <span class="param-type"><a href="grpc-Call.html">grpc~Call</a></span>
  917. </td>
  918. <td class="description last"><p>The call object that will be returned by the client method</p></td>
  919. </tr>
  920. <tr>
  921. <td class="name"><code>channel</code></td>
  922. <td class="type">
  923. <span class="param-type"><a href="grpc.Channel.html">grpc.Channel</a></span>
  924. </td>
  925. <td class="description last"><p>The channel that will be used to make a request</p></td>
  926. </tr>
  927. <tr>
  928. <td class="name"><code>methodDefinition</code></td>
  929. <td class="type">
  930. <span class="param-type"><a href="grpc.html#~MethodDefinition">grpc~MethodDefinition</a></span>
  931. </td>
  932. <td class="description last"><p>The MethodDefinition object that describes this method</p></td>
  933. </tr>
  934. <tr>
  935. <td class="name"><code>options</code></td>
  936. <td class="type">
  937. <span class="param-type"><a href="grpc.Client.html#~CallOptions">grpc.Client~CallOptions</a></span>
  938. </td>
  939. <td class="description last"><p>The call options passed when making this request</p></td>
  940. </tr>
  941. <tr>
  942. <td class="name"><code>callback</code></td>
  943. <td class="type">
  944. <span class="param-type"><a href="grpc.Client.html#~requestCallback">grpc.Client~requestCallback</a></span>
  945. </td>
  946. <td class="description last"><p>The callback that will handle the response.
  947. Only present if this method is unary or client streaming.</p></td>
  948. </tr>
  949. </tbody>
  950. </table>
  951. </dl>
  952. </dl>
  953. </dd>
  954. <hr>
  955. <dt>
  956. <h4 class="name" id="~requestCallback"><span class="type-signature"></span>requestCallback(error, value)</h4>
  957. </dt>
  958. <dd>
  959. <h5>Parameters:</h5>
  960. <table class="params table table-striped">
  961. <thead>
  962. <tr>
  963. <th>Name</th>
  964. <th>Type</th>
  965. <th>Argument</th>
  966. <th class="last">Description</th>
  967. </tr>
  968. </thead>
  969. <tbody>
  970. <tr>
  971. <td class="name"><code>error</code></td>
  972. <td class="type">
  973. <span class="param-type"><a href="grpc.html#~ServiceError">grpc~ServiceError</a></span>
  974. </td>
  975. <td class="attributes">
  976. &lt;nullable><br>
  977. </td>
  978. <td class="description last"><p>The error, if the call
  979. failed</p></td>
  980. </tr>
  981. <tr>
  982. <td class="name"><code>value</code></td>
  983. <td class="type">
  984. <span class="param-type">*</span>
  985. </td>
  986. <td class="attributes">
  987. </td>
  988. <td class="description last"><p>The response value, if the call succeeded</p></td>
  989. </tr>
  990. </tbody>
  991. </table>
  992. <dl class="details">
  993. </dl>
  994. </dd>
  995. </dl>
  996. </article>
  997. </section>
  998. </div>
  999. </div>
  1000. <div class="clearfix"></div>
  1001. <div class="col-md-3">
  1002. <div id="toc" class="col-md-3 hidden-xs hidden-sm hidden-md"></div>
  1003. </div>
  1004. </div>
  1005. </div>
  1006. <div class="modal fade" id="searchResults">
  1007. <div class="modal-dialog">
  1008. <div class="modal-content">
  1009. <div class="modal-header">
  1010. <button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">&times;</span></button>
  1011. <h4 class="modal-title">Search results</h4>
  1012. </div>
  1013. <div class="modal-body"></div>
  1014. <div class="modal-footer">
  1015. <button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
  1016. </div>
  1017. </div><!-- /.modal-content -->
  1018. </div><!-- /.modal-dialog -->
  1019. </div>
  1020. <footer>
  1021. <span class="jsdoc-message">
  1022. Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a>
  1023. on 2019-07-15T16:38:16-07:00
  1024. using the <a href="https://github.com/docstrap/docstrap">DocStrap template</a>.
  1025. </span>
  1026. </footer>
  1027. <script src="scripts/docstrap.lib.js"></script>
  1028. <script src="scripts/toc.js"></script>
  1029. <script type="text/javascript" src="scripts/fulltext-search-ui.js"></script>
  1030. <script>
  1031. $( function () {
  1032. $( "[id*='$']" ).each( function () {
  1033. var $this = $( this );
  1034. $this.attr( "id", $this.attr( "id" ).replace( "$", "__" ) );
  1035. } );
  1036. $( ".tutorial-section pre, .readme-section pre, pre.prettyprint.source" ).each( function () {
  1037. var $this = $( this );
  1038. var example = $this.find( "code" );
  1039. exampleText = example.html();
  1040. var lang = /{@lang (.*?)}/.exec( exampleText );
  1041. if ( lang && lang[1] ) {
  1042. exampleText = exampleText.replace( lang[0], "" );
  1043. example.html( exampleText );
  1044. lang = lang[1];
  1045. } else {
  1046. var langClassMatch = example.parent()[0].className.match(/lang\-(\S+)/);
  1047. lang = langClassMatch ? langClassMatch[1] : "javascript";
  1048. }
  1049. if ( lang ) {
  1050. $this
  1051. .addClass( "sunlight-highlight-" + lang )
  1052. .addClass( "linenums" )
  1053. .html( example.html() );
  1054. }
  1055. } );
  1056. Sunlight.highlightAll( {
  1057. lineNumbers : false,
  1058. showMenu : true,
  1059. enableDoclinks : true
  1060. } );
  1061. $.catchAnchorLinks( {
  1062. navbarOffset: 10
  1063. } );
  1064. $( "#toc" ).toc( {
  1065. anchorName : function ( i, heading, prefix ) {
  1066. return $( heading ).attr( "id" ) || ( prefix + i );
  1067. },
  1068. selectors : "#toc-content h1,#toc-content h2,#toc-content h3,#toc-content h4",
  1069. showAndHide : false,
  1070. smoothScrolling: true
  1071. } );
  1072. $( "#main span[id^='toc']" ).addClass( "toc-shim" );
  1073. $( '.dropdown-toggle' ).dropdown();
  1074. $( "table" ).each( function () {
  1075. var $this = $( this );
  1076. $this.addClass('table');
  1077. } );
  1078. } );
  1079. </script>
  1080. <!--Navigation and Symbol Display-->
  1081. <!--Google Analytics-->
  1082. <script type="text/javascript">
  1083. $(document).ready(function() {
  1084. SearcherDisplay.init();
  1085. });
  1086. </script>
  1087. </body>
  1088. </html>