rongjs
v1.2.1
Published
一个充满少女心的 JS 迷你库,提供趣味功能和浏览器 API 封装。A cute and fun JavaScript library with fun features and browser API wrappers.
Maintainers
Readme
RongJS 💖
一个充满少女心的 JS 迷你库,提供趣味功能和浏览器 API 封装。
✨ 特性
- 趣味功能: 内置“今日幸运色”和“彩虹屁生成器”,让你的一天充满好心情!
- 浏览器 API 封装: 简化了地理定位 (
Geolocation) 和电池状态 (Battery Status) 等常用 API 的调用。 - 轻量级: 零依赖,体积小,开箱即用。
- 现代化: 使用 ES Module 和
async/await等现代 JavaScript 特性。
🚀 安装
使用 npm 安装 RongJS:
npm install rongjs💡 使用方法
在你的 JavaScript 文件中导入并使用:
import Rong from 'rongjs';
// --- 使用趣味功能 ---
// 获取今日幸运色
const color = Rong.Fun.getLuckyColor();
console.log(`你的幸运色是 ${color.name} (${color.hex})!`);
// 获取一句赞美
const compliment = Rong.Fun.getCompliment();
console.log(compliment);
// --- 使用浏览器 API (仅在浏览器环境中有效) ---
// 查找附近的咖啡店
async function findCoffee() {
try {
const shops = await Rong.Geo.findNearbyCoffeeShops();
console.log('附近的咖啡店:', shops);
} catch (error) {
console.error(error.message);
}
}
findCoffee();模块 API
Rong.Fun
getLuckyColor(): 返回一个包含{ name, hex }的幸运色对象。getCompliment(): 返回一句字符串格式的赞美。
Rong.Geo (浏览器专用)
findNearbyCoffeeShops(): 返回一个 Promise,解析后得到一个模拟的咖啡店列表。
Rong.Device (浏览器专用)
getBatteryStatus(): 返回一个 Promise,解析后得到包含{ level, charging }的电池状态对象。
📝 许可证
MIT
