المهارات @azure/storage-file-share (TypeScript/JavaScript)
📦

@azure/storage-file-share (TypeScript/JavaScript)

آمن

إدارة ملفات Azure File Shares باستخدام TypeScript

تبسيط تكامل Azure File Share مع أمثلة TypeScript جاهزة للاستخدام. توفر هذه المهارة المرجعية أنماط كود لعمليات ملفات SMB والمصادقة ومعالجة الأخطاء.

يدعم: Claude Codex Code(CC)
🥉 72 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "@azure/storage-file-share (TypeScript/JavaScript)". أرني كيفية إنشاء مشاركة ورفع ملف

النتيجة المتوقعة:

أنشئ ShareServiceClient باستخدام سلسلة الاتصال الخاصة بك، واحصل على ShareClient لاسم المشاركة، واستخدم طريقة create()، ثم احصل على FileClient واستخدم uploadRange() لرفع المحتوى.

استخدام "@azure/storage-file-share (TypeScript/JavaScript)". كيف أقوم بتنزيل ملف من Azure File Share؟

النتيجة المتوقعة:

استخدم طريقة ShareFileClient.download() للحصول على تدفق قابل للتنزيل، ثم اقرأ الأجزاء من خاصية readableStreamBody واجمعها في Buffer.

التدقيق الأمني

آمن
v1 • 2/25/2026

Prompt-only documentation skill with no executable code. Contains TypeScript examples for Azure SDK usage. No security risks detected. All code examples are reference documentation demonstrating legitimate Azure Storage File Share operations.

0
الملفات التي تم فحصها
0
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
74
الامتثال للمواصفات

ماذا يمكنك بناءه

مطور الواجهة الخلفية يدمج Azure File Storage

مطور يبني تطبيق Node.js يحتاج لتخزين واسترجاع الملفات من Azure File Shares باستخدام بروتوكول SMB. يحتاج مرجع سريع للكود للمصادقة وعمليات الملفات.

مهندس DevOps يكوين التخزين السحابي

مهندس يخطط لسير عمل آلي يتفاعل مع Azure File Shares. يحتاج أمثلة لإنشاء الحصص وتعيين الحصص وإدارة الأدلة برمجياً.

مطور Full-stack يهاجر تخزين الملفات

مطور يهاجر من أنظمة الملفات المحلية إلى Azure Storage File Shares. يحتاج إرشادات لأنماط الرفع ومعالجة التدفقات ومعالجة الأخطاء للاستخدام الإنتاجي.

جرّب هذه الموجهات

رفع الملف الأساسي 
أرني كيفية رفع ملف إلى Azure File Share باستخدام TypeScript
عرض محتويات الدليل 
كود لعرض جميع الملفات والأدلة في دليل Azure File Share
رفع ملف كبير باستخدام التدفقات 
كيف أقوم برفع ملف كبير باستخدام التدفقات إلى Azure File Share في Node.js؟
إنشاء رمز SAS 
أرني كيفية إنشاء رمز SAS للوصول الآمن للملفات مع صلاحيات محددة

أفضل الممارسات

  • استخدم DefaultAzureCredential لبيئات الإنتاج بدلاً من بيانات الاعتماد المكتوبة بشكل ثابت
  • عيّن حصصاً على المشاركات لمنع تكاليف التخزين غير المتوقعة من نمو الملفات غير المحدود
  • استخدم طرق التدفق للملفات الكبيرة لتجنب تحميل الملفات بالكامل في الذاكرة
  • عالج استثناءات RestError بالتحقق من statusCode لحالات الخطأ المحددة

تجنب

  • لا تكتب مفاتيح حساب التخزين أو سلاسل الاتصال بشكل ثابت في الكود المصدري
  • تجنب استخدام uploadRange للملفات الكبيرة عندما يكون uploadStream أكثر كفاءة
  • لا تهمل معالجة الأخطاء - يمكن أن تفشل عمليات Azure بسبب مشاكل الشبكة أو المصادقة
  • لا تسجل أو تكشف رموز SAS أو مفاتيح حساب التخزين في رسائل الخطأ

الأسئلة المتكررة

ما طريقة المصادقة التي يجب أن أستخدمها؟
استخدم سلاسل الاتصال للتطوير المحلي. للإنتاج، استخدم DefaultAzureCredential مع الهويات المُدارة للمصادقة الآمنة بدون مفاتيح.
هل يمكنني استخدام هذه المهارة في تطبيقات المستعرض؟
بعض الميزات مثل إنشاء SAS وعمليات الملفات خاصة بـ Node.js فقط. يجب أن تستخدم تطبيقات المستعرض رموز SAS المُنشأة مسبقاً للمصادقة.
كيف أتعامل مع رفع الملفات الكبيرة؟
استخدم طريقة uploadStream() مع حجم buffer قابل للتكوين التزامن للملفات أكبر من 256 ميجابايت لتجنب مشاكل الذاكرة.
ما الفرق بين ShareClient و ShareDirectoryClient؟
يعمل ShareClient على مستوى المشاركة للحظات والت لقوات. يتعامل ShareDirectoryClient مع عمليات الملفات والأدلة داخل المشاركة.
كيف أقوم بتنفيذ معالجة الأخطاء؟
است捕获 استثناءات RestError وتحقق من خاصية statusCode. تعامل مع 404 للملفات غير الموجودة، و409 للتعارضات، و403 لأخطاء رفض الوصول.
هل يمكنني إنشاء لقطات لمشاركات الملفات الخاصة بي؟
نعم، استخدم shareClient.createSnapshot() لإنشاء لقطات في وقت معين. الوصول للقطات باستخدام طريقة withSnapshot() والحذف باستخدام خيار deleteSnapshots.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

المستودع

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-storage-file-share-ts

مرجع

main

بنية الملفات

📄 SKILL.md