Hacker News

API ɗin mafi kyawun rafukan yana yiwuwa don JavaScript

Sharhi

16 min read Via blog.cloudflare.com

Mewayz Team

Editorial Team

Hacker News

JavaScript's Streams API yana da Matsala - Kuma Masu Haɓakawa Suna Magana Game da Shi A ƙarshe

Idan kun taɓa ƙoƙarin yin amfani da Streams API a cikin JavaScript don wani abu da ya wuce misalin littafin karatu, kun ji takun-saka. Abin da ya kamata ya zama kyakkyawa, ƙayyadaddun abstraction don sarrafa bayanan jeri - karanta fayiloli, sarrafa martanin HTTP, canza saitin bayanai a cikin ainihin lokaci - sau da yawa yakan shiga cikin tukunyar jirgi na verbose, rikice-rikice na juzu'i, da saman API wanda ke jin kamar Java na kasuwanci fiye da JavaScript na zamani. Tattaunawar da ake yi game da gina ingantacciyar hanyar yawo ta kasance tana yin taɗi cikin shawarwarin TC39, tattaunawar tsarin, da ayyukan buɗe ido na tsawon shekaru. A cikin 2026, yana kaiwa ga gaci. Tambayar ba shine ko mafi kyawun rafukan API zai yiwu ba - abin da "mafi kyau" ya kasance a zahiri, da kuma abin da ke riƙe mu.

Inda API ɗin Rafukan Yanzu Ya Faɗuwa Gajere

Ka'idodin WHATWG Streams Standard, wanda ke ba da iko ReadableStream, WritableStream, da TransformStreama cikin masu bincike da runtimes kamar Node.js da Deno, shine nasarar aikin injiniya na gaske. Ya kawo matsi na baya, sokewa, da haɓakar async zuwa sarrafa bayanan asalin gidan yanar gizo. Amma a aikace, API ɗin yana tambayar mai haɓakawa da yawa don ayyukan gama gari. Ƙirƙirar sauƙaƙan rafi yana buƙatar ƙaddamar da TransformStream tare da hanyar canza, sarrafa masu sarrafawa, da kuma kula da ma'anar fassarar a hankali - duk ga abin da ya kai taswira () sama da gungu-gungu.

Kwatanta wannan da yadda masu haɓaka ke aiki tare da tsararraki. Array.prototype.map(), filter(), da reduce() suna iya haɗawa, ana iya karantawa, kuma suna buƙatar kusan bikin sifili. API ɗin Rafukan da ke ba da ɗayan wannan ergonomic composability daga cikin akwatin. Bututun ruwa tare ta hanyar .pipeThrough() yana aiki, amma gina matakan canzawa da kansu shine inda masu haɓaka ke rasa sa'o'i da haƙuri. Kuskuren sarrafa sarƙoƙin bututun wani abu ne mai zafi - kurakurai ba sa yaduwa da hankali, kuma gyara bututun da ya karye sau da yawa yana nufin shigar da sauye-sauye na lokaci na wucin gadi don gano inda ake jefar ko lalata bayanai.

Hakanan akwai giwar Node.js a cikin dakin. Node yana da nasa aiwatar da rafi na gado (stream. Readable, stream.Rubuta), wanda ya rigaya mizanin WHATWG da kusan shekaru goma. Tsarukan biyu suna yin mu'amala ne ta hanyar adaftar kayan aiki, kuma yawancin fakitin npm har yanzu suna amfani da tsohuwar API. Masu haɓakawa da ke aiki a cikin mahalli - fassarar gefen uwar garke, ayyuka na gefe, sarrafa tushen burauza - ana tilasta su jujjuya abubuwan da ba su dace ba don ra'ayi iri ɗaya.

Mene Mafi Kyawun Rafukan API Zai Iya Kama

Shawarwari da yawa da gwaje-gwajen al'umma suna nuni zuwa ga ƙarin abokantaka na gaba. Mahimman ra'ayoyin suna ci gaba da haɗuwa akan wasu ƙa'idodi:ayyukan aiki, async iterator alignment, da rage tukunyar jirgi. Ka yi tunanin samun damar rubuta bututun bayanai masu yawo a zahiri yayin da kake rubuta sauye-sauyen tsari - sarkar .map(), .tace() , da .take() kai tsaye akan rafi da za'a iya karantawa ba tare da buƙatar gina abubuwan Canjawa na tsaka-tsaki ba.

Wannan ba hasashe ba ne. Shawarar Iterator Helpers (yanzu a mataki na 4 a cikin TC39) ya riga ya kawo .map(), .filter(), .take () , .drop() , da .flatMap() zuwa daidaitawa. Ƙaddamar da wannan ƙirar zuwa masu daidaitawa - kuma ta tsawo, zuwa rafukan da za a iya karantawa waɗanda ke fallasa [Symbol.asyncIterator] - mataki ne na gaba na halitta. Wasu lokutan gudu da dakunan karatu sun riga sun fara gwaji tare da wannan hanyar, barin masu haɓakawa su rubuta lamba kamar:

Mafi girman ƙaƙƙarfan ƙa'idar yawo shine wanda ya ɓace. Lokacin da masu haɓakawa za su iya bayyana sauye-sauyen bayanai azaman jerin ayyuka masu sauƙi - ba tare da damuwa game da masu sarrafawa ba, dabarun layi, ko matsi na hannu - suna gina sauri, suna jigilar ƙananan kwari, kuma a zahiri suna jin daɗin aiki tare da bayanan yawo.

Manufar ba shine maye gurbin ƙananan matakan Rafukan API gaba ɗaya ba. Koyaushe za a sami shari'o'in amfani - ka'idodin al'ada, sarrafa ƙwaƙwalwar ajiya mai kyau, aiwatar da codec na binary - inda samun damar mai sarrafawa kai tsaye yana da mahimmanci. Amma ga 90% na shari'o'in amfani da suka haɗa da karantawa, canzawa, da rubuta bayanan jeri-nauyi, ya kamata ma'aunin abstraction ya dace da sauƙin aikin.

Darussa Daga Sauran Muhalli

JavaScript ba shine yaren farko da ake kokawa da ergonomics mai yawo ba. Rust'sIteratorda Rafihalaye suna ba da haƙƙin haɗe-haɗe, ƙarancin tsadar sifili wanda ke ba masu haɓakawa damar sarkar ayyukansu ba tare da ware tarin matsakaici ba. Tsarin Elixir na Stream yana ba da ƙididdige ƙididdigewa tare da tsaftataccen tsarin haɗin bututu. Hatta Java, sau da yawa ana sukar magana, an gabatar da java.util.stream.Stream a cikin Java 8 tare da API ɗin da ya dace wanda masu haɓaka JavaScript za su gane da hassada.

Abin da waɗannan mahalli ke rabawa shine sadaukarwa don mai da al'amarin gama gari maras muhimmanci. Karatun fayil, layukan tacewa, da sakamakon rubutu yana ɗaukar layukan 3-5 na lambar ƙira. A cikin API ɗin Rafukan Rafukan JavaScript na yanzu, aiki iri ɗaya na iya faɗaɗa cikin sauƙi zuwa layi 20-30 lokacin da kuka ƙididdige ginin rafi, sarrafa kuskure, da tsagewar da ta dace. Ratar ba game da iyawa ba ne - game da ergonomics ne.

Hanyoyin Python ma yana da koyarwa. Ayyukan janareta tare da haɓaka suna samar da wata hanya ta halitta don ƙirƙira da cinye bayanan jeri a kasala. JavaScript yana da ayyukan janareta shima, amma haɗa su zuwa API ɗin Rafu yana buƙatar nannade su a cikin ReadableStream Builders tare da masu sarrafa tushen ja. Haɗin kai tsakanin janareta da rafuffuka - inda aikin janareta zai iya zama rafi da za a iya karantawa kai tsaye - zai kawar da dukkan nau'ikan tukunyar jirgi.

Tasirin Haƙiƙanin Duniya akan Ci gaban Aikace-aikacen

Wannan ba damuwa ba ce ta ilimi. Bayanan da ke gudana shine tushen tushen aikace-aikacen gidan yanar gizo na zamani. Abubuwan da aka aika da sabar, martanin HTTP chunked, dashboards na nazari na ainihin-lokaci, sarrafa fayil ɗin sarrafa fayil, fitowar samfurin AI - waɗannan fasalulluka ne na yau da kullun, ba lokuta na gaba ba. Lokacin da streaming primitive ke da wuya a yi amfani da shi, masu haɓakawa ko dai su guje shi gaba ɗaya (suntsaye komai cikin ƙwaƙwalwar ajiya, wanda ba ya ƙima) ko kuma su gina bututun da ba su da ƙarfi, mai wuyar kiyayewa waɗanda suka zama tushen abubuwan samarwa.

Yi la'akari da abin da ke faruwa a ma'auni. Wani dandali kamarMewayz, wanda ke aiwatar da bayanai a cikin 207 hadedde tsarin kasuwanci - daga bututun CRM da daftarin aiki zuwa lissafin biyan kuɗi da bin diddigin jiragen ruwa - yana ɗaukar babban kundin bayanan jeri na ciki. Ayyukan fitarwa, samar da rahoto, sarrafa abubuwan da suka faru na gidan yanar gizo, da sabunta dashboard na ainihin lokaci duk suna amfana daga ingantaccen yawo. Lokacin da asalin harshe na asali ya sa yawo cikin wahala, farashi yana ninkawa a kowane tsari da kowane kwararar bayanai. Injiniyoyin dandali sun ƙare suna gina ƙayyadaddun abubuwan yawo na ciki a saman abubuwan da ke tattare da harshe, suna ƙara haɗaɗɗiyar da bai kamata ba.

💡 DID YOU KNOW?

Mewayz replaces 8+ business tools in one platform

CRM · Invoicing · HR · Projects · Booking · eCommerce · POS · Analytics. Free forever plan available.

Start Free →
  • Sarrafa fayil: Lodawa da rarraba fayilolin CSV tare da layuka 100K+ yana buƙatar yawo don guje wa gajiyar ƙwaƙwalwa - amma API na yanzu yana yin madaidaicin juzu'i-jere-jere verbose
  • Dashboards na lokaci-lokaci: Bayanan bincike mai yawo daga uwar garken zuwa abokin ciniki ta hanyar SSE ko WebSocket fa'idodin daga sauye-sauye masu iya haɗawa (Tari, tacewa, throttling) waɗanda ke da zafi don bayyanawa a yau
  • Rashin amsawa ta AI: Kamar yadda fasalulluka masu ƙarfi na LLM suka zama daidaitattun kayan aikin kasuwanci, yawo amsoshi-ta-token martani ga UI shine tsammanin tushen tushe - kuma cikakkiyar yanayin amfani don canjin rafi mai sarkarwa
  • Ayyukan batch: Gudanar da biyan albashi ga dubban ma'aikata, samar da daftari mai yawa, ko daidaita bayanan CRM tare da tsarin waje duk sun haɗa da watsa bayanai ta hanyar inganci, canji, da matakan fitarwa
  • Webhook bututun: Shigarwa, ingantawa, sarrafawa, da sarrafa abubuwan da ke shigowa yanar gizo daga haɗe-haɗe na ɓangare na uku babban nauyin aiki ne mai yawo

Abinda Ake Gabatarwa

Tsarin muhalli na JavaScript yana tafiya ta fuskoki da yawa. Shawarar ta TC39Iterator Helpersta riga ta sauka, tana kawo abun da ke aiki ga masu yin aiki tare. Ƙaddamar da yanayi - Async Iterator Helpers - zai kawo iri ɗaya .map() , .filter () , .reduce() , .take () , da .flatMap () hanyoyi don daidaita masu iterators, waɗanda za'a iya karantawa ta hanyar rafi. [Symbol.asyncIterator] . Wannan kadai zai inganta haɓaka ƙwarewar haɓaka don mafi yawan tsarin yawo.

Bayan TC39, sabbin matakan-lokaci suma suna tura iyaka. Deno ya gwada da ƙarin kayan aikin rafi na ergonomic. TheAkwatin Kayan aiki na Rafukan Yanar Gizoda makamantan ɗakunan karatu na al'umma suna ba da ayyuka masu taimako waɗanda ke kunshe sassan magana na API. Kuma akwai ci gaba mai girma a bayan ra'ayin a'amar madaidaicin ɗakin karatu - saitin ginannen, ingantattun kayan aiki don ayyukan yawo na gama gari kamar tsagawar layi, sarrafa JSON, sarrafa CSV, da matsawa waɗanda masu haɓakawa a halin yanzu ke ja daga npm.

Har ila yau, akwai hujja mai tursasawa don mafi kyawun fassarar kuskure. A cikin API na yau, kuskure a cikin sarkar bututu na iya barin rafuka a cikin jahohin da ba su da tabbas - an cinye su, tare da makullai masu tsinke. API ɗin da aka sake dubawa zai iya ɗaukar tsarin yaɗa kurakurai mai kama da nau'in Rust's Result ko ɗaukar al'ada inda kurakurai ke gudana ta cikin bututun azaman dabi'u, yana barin matakan ƙasa don ɗauka ko murmurewa daga gare su ba tare da keta dukkan sarkar ba. Wannan zai zama canji don amincin samarwa.

Me yasa Wannan Yafi Komai A cikin 2026

Hanyoyi guda uku masu haɗuwa suna sa API ergonomics ya fi gaggawa a yanzu fiye da kowane lokaci a tarihin JavaScript. Na farko, ƙididdige ƙididdiga - Ma'aikatan Cloudflare, Ayyukan Vercel Edge, Deno Deploy - yana aiki a ƙarƙashin ƙaƙƙarfan ƙwaƙwalwar ajiya da ƙuntatawar CPU inda buffer gabaɗayan amsa ko bayanan bayanai ba su da amfani. Yawo shine kawai zaɓi, kuma masu haɓakawa da ke tura waɗannan mahallin suna buƙatar API wanda baya yaƙar su.

Na biyu, Haɗin AI ya sanya yawo ya zama fasalin mai amfani. Lokacin da mataimaki na AI ya haifar da amsa, masu amfani suna tsammanin ganin alamun suna bayyana a ainihin lokacin, ba jira duk amsa ga buffer ba. Kowane dandamali na SaaS - daga tsarin aiki na kasuwanci kamar Mewayz zuwa kayan aikin AI na tsaye - yanzu yana buƙatar ingantaccen amfani da rafi na abokin ciniki. API ɗin na yanzu yana aiki don wannan, amma ƙwarewar mai haɓakawa na rarrabawa, canzawa, da kuma samar da fitowar AI mai gudana zai iya zama mafi kyau sosai tare da masu sarrafa rafi.

Na uku, motsincikakkun JavaScript yana nufin masu haɓakawa suna sarrafa rafuka a bangarorin biyu na iyakar hanyar sadarwa. Injiniyan injiniya guda ɗaya na iya rubuta rafi na gefen uwar garken wanda ke aiwatar da sakamakon binciken bayanai, bututun su ta hanyar canji, aika su azaman martanin HTTP chunked, sannan ya cinye wannan rafi akan abokin ciniki don samar da UI mai ci gaba. Lokacin da API mai gudana ya kasance mai banƙyama, ana jin wannan gogayya a kowane yanki na tari.

Motsa Gaba: Abin da Masu Haɓakawa Zasu Iya Yi A Yau

Yayin da harshen ke tasowa, masu haɓakawa ba su makale suna jira. Dabaru masu amfani da yawa na iya haɓaka ƙwarewar yawo a cikin ayyukan yanzu. Yin amfani daasync janaretaa matsayin ƙirar mawallafi na farko - da kuma nannade su a cikin ReadableStream.from () inda lokacin gudu ke goyan bayan shi - yana ba da ingantaccen tsarin daidaitawa fiye da sarrafa mai sarrafa hannu. Dakunan karatu kamar suit-pipeda kuma streaming-itereables suna ba da mataimaka masu iya haɗawa waɗanda ke kawo sarkar aiki ga masu yin amfani da su a yau.

Don ƙungiyoyin haɓaka aikace-aikacen bayanai, saka hannun jari a cikin sirara mai yawo na ciki yana biyan riba. Kyakkyawan tsara streamMap () , streamFilter () , da streamBatch() saitin ayyuka - kowanne yana ɗaukar async mai iya yin amfani da shi kuma yana maido da async mai iya daidaitawa - yana ba da ƙayyadaddun daidaitattun API ɗin, ba tare da nauyin cikakken tsarin yawo ba. Wannan shine tsarin da ya tashi daga samfuran farawa zuwa dandamali masu sarrafa miliyoyin ayyuka.

  1. Ɗauki async janareta a matsayin tsohowar ƙirar ku don samar da bayanan yawo - sun fi tsafta, mafi iya gwadawa, kuma sun fi dacewa fiye da ginin ReadableStream na manual
  2. Yi amfani da ReadableStream.from() domin haɗa abubuwan da za'a iya daidaita su cikin rafukan yanar gizo a duniya lokacin da kuke buƙatar haɗin gwiwa tare da APIs waɗanda ke tsammanin misalin ReadableStream
  3. Gina ko ɗaukar ayyukan amfani na bakin cikidon ayyukan gama gari (taswira, tacewa, tsari, magudanar ruwa) akan async iterables maimakon gina abubuwan TransformStream
  4. Mai ba da shawara a cikin TC39 da tattaunawar lokaci-lokaci - shawarwarin async iterator helpers yana buƙatar muryoyin masu haɓakawa suna turawa don fifiko
  5. Rubuta gwaje-gwaje a kan async iterables, ba rafukan kai tsaye ba - wannan yana sa dabarun yawo da sauƙi don ingantawa
API ɗin JavaScript Streams ya kasance tushe mai mahimmanci. Amma ana nufin gina harsashi a kai, kuma Layer na gaba na abstraction - wanda ke sanya yawo a matsayin na halitta kamar aiki tare da tsararru - ya ƙare. Guda-gut ɗin suna cikin wurin: async iterators, ayyukan janareta, da ƙirar mataimaka masu ƙarfi. Abin da ake buƙata a yanzu shine nufin gama kai don haɗa su cikin ma'auni wanda ya dace da yadda masu haɓakawa ke tunanin ainihin bayanan jeri. Sakamakon ba kawai zai zama mafi kyawun API ba - zai buɗe yawo a matsayin tsarin tsoho maimakon makoma ta ƙarshe, yin aikace-aikace cikin sauri, ingantaccen ƙwaƙwalwar ajiya, kuma mafi daɗin ginawa.

Tambayoyin da ake yawan yi

Mene ne ke damun API ɗin Rafukan JavaScript na yanzu?

API ɗin Rafukan na yanzu yana fama da matsanancin tukunyar tukunyar jirgi, rikice-rikice na matsi na baya, da rikitaccen saman API wanda ke hana karɓuwa. Ayyuka masu sauƙi kamar karanta fayil ko sarrafa martanin HTTP suna buƙatar ƙarin lamba fiye da buƙata. Masu haɓakawa sukan yi amfani da dakunan karatu na ɓangare na uku ko tsofaffin ƙira kamar kira baya da masu fitar da taron, suna ƙetare ma'auni gaba ɗaya saboda ergonomics suna jin kusanci da Java ɗin kasuwanci fiye da JavaScript na zamani.

Ta yaya mafi kyawun rafukan API zai inganta ci gaban yanar gizo?

API ɗin rafukan da aka sake fasalin tare da tsaftataccen tsattsauran ra'ayi, ginanniyar goyan bayan maimaitawar async, da hanyoyin haɗaɗɗun ƙira za su sauƙaƙa sarrafa bayanai na ainihin lokaci. Masu haɓakawa za su iya sarƙar sauye-sauye ta zahiri, sarrafa matsi na baya a bayyane, da rubuta bututun yawo a cikin ɗan guntun lambar. Wannan zai sa ci gaba da aiwatarwa, ciyarwar bayanai kai tsaye, da manyan sarrafa fayil ga kowane mai haɓaka JavaScript, ba kawai waɗanda ke son yin kokawa da ƙananan matakan farko ba.

Shin dandamali na kasuwanci na zamani na iya iya sarrafa bayanan lokaci-lokaci yadda ya kamata?

E - dandamali kamar Mewayz, OS na kasuwanci-module 207 wanda ke farawa daga $19/mo, tuni ya yi amfani da ingantaccen bututun bayanai a bayan fage don nazari, ayyukan sarrafa kansa, da kuma kai rahoto. Kamar yadda ƙa'idodin yawo ya inganta a cikin JavaScript, kayan aikin da aka gina akan tarin gidan yanar gizo za su isar da ko da gogewar lokaci mai sauri, daga sabuntar dashboard ɗin nan take zuwa sarrafa fayil ɗin maras sumul a cikin haɗe-haɗen kasuwanci.

Waɗanne hanyoyi ne ke wanzu yayin da API ɗin Rafukan ke tasowa?

A halin yanzu masu haɓakawa sun dogara da dakunan karatu kamar rafukan Node.js, RxJS don shirye-shiryen amsawa, ko async janareta waɗanda aka haɗa tare da madaukai masu jiran-jini don sarrafa bayanan jeri-jeri fiye da ergonomics. Abubuwan da suka dace da yanar gizo da masu taimaka-mataki-mataki suma suna cike giɓi a daidaitaccen API. Makullin shine zabar abstractions waɗanda suka yi daidai da yanayin amfani da ku - ko wannan yana nufin alamu da za a iya gani don aikace-aikace masu nauyi ko kuma sauƙi mai sauƙi na async don ayyukan sauya bayanan kai tsaye.