روش های جایگزین برای افزودن Firebase به پروژه جاوا اسکریپت
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
برای اکثر برنامه های وب Firebase، ما قویاً استفاده از SDK از طریق npm را توصیه می کنیم. با این حال، برای کاربران با شرایط خاص، Firebase راههای جایگزینی را برای افزودن SDK ارائه میکند. این صفحه دستورالعمل های دقیق راه اندازی این روش های جایگزین را ارائه می دهد:
CDN (شبکه تحویل محتوا)
npm برای برنامه های Node.js
با استفاده از این روش ها، می توانید هر یک از کتابخانه های موجود را به برنامه خود اضافه کنید.
از CDN
میتوانید واردات جزئی FirebaseJavaScript SDK را پیکربندی کنید و فقط محصولات Firebase را که نیاز دارید بارگیری کنید. Firebase هر کتابخانه ای از FirebaseJavaScript SDK را در CDN جهانی ما (شبکه تحویل محتوا) ذخیره می کند.
برای اینکه فقط محصولات Firebase خاص را شامل شود (به عنوان مثال، Authentication و Cloud Firestore )، اسکریپت زیر را به پایین تگ <body> خود اضافه کنید، اما قبل از استفاده از خدمات Firebase:
<body>
<!--InsertthisscriptatthebottomoftheHTML,butbeforeyouuseanyFirebaseservices-->
<scripttype="module">
import{initializeApp}from'https://www.gstatic.com/firebasejs/12.2.1/firebase-app.js'// If you enabled Analytics in your project, add the Firebase SDK for Google Analyticsimport{getAnalytics}from'https://www.gstatic.com/firebasejs/12.2.1/firebase-analytics.js'// Add Firebase products that you want to useimport{getAuth}from'https://www.gstatic.com/firebasejs/12.2.1/firebase-auth.js'import{getFirestore}from'https://www.gstatic.com/firebasejs/12.2.1/firebase-firestore.js'</script>
</body>
شی پیکربندی Firebase خود را اضافه کنید و سپس Firebase را در برنامه خود مقداردهی کنید:
<body>
<scripttype="module">
// ...// TODO: Replace the following with your app's Firebase configurationconstfirebaseConfig={// ...};// Initialize Firebaseconstapp=initializeApp(firebaseConfig);</script>
</body>
برنامه های Node.js
FirebaseJavaScript SDK را نصب کنید:
اگر قبلاً فایل package.json ندارید، با اجرای دستور زیر از ریشه پروژه جاوا اسکریپت خود، آن را ایجاد کنید:
npm init
بسته firebase npm را نصب کرده و با اجرای زیر در فایل package.json خود ذخیره کنید:
npm install --save firebase@12.2.1
برای استفاده از ماژول Firebase در برنامه خود از یکی از گزینه های زیر استفاده کنید:
شما می توانید ماژول ها را از هر فایل جاوا اسکریپت require
// Firebase App (the core Firebase SDK) is always required and// must be listed before other Firebase SDKsvarfirebase=require("firebase/app");// Add the Firebase products that you want to userequire("firebase/auth");require("firebase/firestore");
شامل کل FirebaseJavaScript SDK، به جای SDK های فردی (برای برنامه های تولیدی توصیه نمی شود)
varfirebase=require("firebase");
برای import ماژول ها می توانید از نحو ESM استفاده کنید
// Firebase App (the core Firebase SDK) is always required and// must be listed before other Firebase SDKsimportfirebasefrom"firebase/app";// Add the Firebase services that you want to useimport"firebase/auth";import"firebase/firestore";
شامل کل FirebaseJavaScript SDK، به جای SDK های فردی (برای برنامه های تولیدی توصیه نمی شود)
importfirebasefrom"firebase";
شی پیکربندی Firebase خود را اضافه کنید و سپس Firebase را در برنامه خود مقداردهی کنید:
import{initializeApp}from'firebase/app';// TODO: Replace the following with your app's Firebase configurationconstfirebaseConfig={//...};// Initialize Firebaseconstapp=initializeApp(firebaseConfig);
تاریخ آخرین بهروزرسانی 2025-08-30 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-30 بهوقت ساعت هماهنگ جهانی."],[],[],null,["\u003cbr /\u003e\n\nFor most Firebase web apps we strongly recommend using\n[the SDK via npm](/docs/web/setup).\nHowever, for users with special requirements, Firebase provides alternative\n[ways to add the SDK](/docs/web/learn-more#ways-to-add-web-sdks).\nThis page provides detailed setup instructions for these alternative methods:\n\n- CDN (content delivery network)\n- npm for Node.js apps\n\nUsing these methods, you can add any of the\n[available libraries](/docs/web/learn-more#available-libraries)\nto your app. \n\nFrom the CDN\n\nYou can configure partial import of the Firebase JavaScript SDK and only load the\nFirebase products that you need. Firebase stores each library of the\nFirebase JavaScript SDK on our global CDN (content delivery network).\n\n1. To include only [specific Firebase products](/docs/web/learn-more#libraries-cdn)\n (for example, Authentication and Cloud Firestore), add the following\n script to the bottom of your `\u003cbody\u003e` tag, but before you use any\n Firebase services:\n\n ```javascript\n \u003cbody\u003e\n \u003c!-- Insert this script at the bottom of the HTML, but before you use any Firebase services --\u003e\n \u003cscript type=\"module\"\u003e\n import { initializeApp } from 'https://www.gstatic.com/firebasejs/12.2.1/firebase-app.js'\n\n // If you enabled Analytics in your project, add the Firebase SDK for Google Analytics\n import { getAnalytics } from 'https://www.gstatic.com/firebasejs/12.2.1/firebase-analytics.js'\n\n // Add Firebase products that you want to use\n import { getAuth } from 'https://www.gstatic.com/firebasejs/12.2.1/firebase-auth.js'\n import { getFirestore } from 'https://www.gstatic.com/firebasejs/12.2.1/firebase-firestore.js'\n \u003c/script\u003e\n \u003c/body\u003e\n ```\n | You can optionally [delay loading of Firebase SDKs](/docs/web/learn-more#delay-sdks-cdn) until the entire page has loaded.\n2. Add your Firebase configuration object, and then initialize Firebase in\n your app:\n\n ```javascript\n \u003cbody\u003e\n \u003cscript type=\"module\"\u003e\n // ...\n\n // TODO: Replace the following with your app's /docs/web/learn-more#config-object\n const firebaseConfig = {\n // ...\n };\n\n // Initialize Firebase\n const app = initializeApp(firebaseConfig);\n \u003c/script\u003e\n \u003c/body\u003e\n ```\n\nNode.js apps**Caution:** The following instructions are for using the Firebase JavaScript SDK as a client for end-user access (for example, in a Node.js desktop or IoT application). To set up administrative access from privileged environments (such as servers), [set up the Firebase Admin SDK](/docs/admin/setup) instead.\n\n1. Install the Firebase JavaScript SDK:\n\n 1. If you don't already have a `package.json` file, create one by\n running the following command from the root of your JavaScript\n project:\n\n ```\n npm init\n ```\n 2. Install the `firebase` npm package and save it to your\n `package.json` file by running:\n\n ```\n npm install --save firebase@12.2.1\n ```\n2. Use one of the following options to use the Firebase module in your app:\n\n - **You can `require` modules from any JavaScript file**\n\n To include only [specific Firebase products](/docs/web/learn-more#libraries-nodejs)\n (like Authentication and Cloud Firestore): \n\n // Firebase App (the core Firebase SDK) is always required and\n // must be listed before other Firebase SDKs\n var firebase = require(\"firebase/app\");\n\n // Add the Firebase products that you want to use\n require(\"firebase/auth\");\n require(\"firebase/firestore\");\n\n Include the entire Firebase JavaScript SDK, rather\n than individual SDKs\n *(not recommended for production apps)*\n | Loading the entire SDK is not efficient for production web apps. \n Use this option for development purposes only. \n\n ```javascript\n var firebase = require(\"firebase\");\n ```\n\n \u003cbr /\u003e\n\n - **You can use ESM syntax to `import` modules**\n\n To include only [specific Firebase products](/docs/web/learn-more#libraries-nodejs)\n (like Authentication and Cloud Firestore): \n\n // Firebase App (the core Firebase SDK) is always required and\n // must be listed before other Firebase SDKs\n import firebase from \"firebase/app\";\n\n // Add the Firebase services that you want to use\n import \"firebase/auth\";\n import \"firebase/firestore\";\n\n Include the entire Firebase JavaScript SDK, rather\n than individual SDKs\n *(not recommended for production apps)*\n | Loading the entire SDK is not efficient for production web apps. \n Use this option for development purposes only. \n\n ```python\n import firebase from \"firebase\";\n ```\n3. Add your Firebase configuration object, and then initialize Firebase in\n your app:\n\n ```javascript\n import { initializeApp } from 'firebase/app';\n\n // TODO: Replace the following with your app's /docs/web/learn-more#config-object\n const firebaseConfig = {\n //...\n };\n\n // Initialize Firebase\n const app = initializeApp(firebaseConfig);\n ```"]]