کتابخانه رایگان سوئیفت برای تجزیه، استخراج و دستکاری داده‌های HTML

شروع کار با SwiftSoup

روش پیشنهادی و آسان‌ترین برای نصب SwiftSoup استفاده از CocoaPods است. لطفاً از دستور زیر برای نصب روان استفاده کنید.

pod 'SwiftSoup'

تجزیه HTML در برنامه‌های Swift

تجزیه HTML در هستهٔ وب اسکریپینگ قرار دارد و SwiftSoup این فرآیند را ساده می‌کند. کتابخانه منبع باز SwiftSoup ویژگی‌های بسیار مفیدی برای بارگذاری و تجزیه اسناد HTML در برنامه‌های Swift ارائه داده است. تنها با چند خط کد، توسعه‌دهندگان می‌توانند محتوای HTML یک صفحه وب را دریافت کرده و شروع به استخراج داده‌های معنادار کنند. این کتابخانه به توسعه‌دهندگان امکان می‌دهد عناصر را با استفاده از سلکتورهای CSS انتخاب کنند، که یافتن نقاط دادهٔ خاص در ساختار HTML را آسان می‌سازد. مثال زیر نشان می‌دهد چگونه می‌توان یک سند HTML را با دستورات Swift تجزیه کرد.

do {
   let html = ""
       + "
HTML تجزیه شد و به یک سند تبدیل شد.
"
   let doc: Document = try SwiftSoup.parse(html)
   return try doc.text()
} catch Exception.Error(let type, let message) {
    print(message)
} catch {
    print("error")
}

استخراج ویژگی‌ها و HTML از عناصر با استفاده از Swift

کتابخانه منبع باز SwiftSoup استخراج ویژگی‌ها و داده‌ها از عناصر HTML را داخل برنامه‌های Swift برای برنامه‌نویسان آسان می‌کند. به عنوان مثال، توسعه‌دهندگان می‌توانند متن، ویژگی‌ها و محتوای HTML را از عناصر تنها با چند خط کد دریافت کنند. روش‌های مختلفی ارائه شده است که می‌تواند به کاربران کمک کند مقدار یک ویژگی، متن یک عنصر و HTML را به دست آورند. مثال زیر نشان می‌دهد چگونه کاربران می‌توانند داده‌های عناصر مختلف را با استفاده از کد Swift دریافت کنند.

do {
    let html: String = "
یک لینک مثال.
"
    let doc: Document = try SwiftSoup.parse(html)
    let link: Element = try doc.select("a").first()!
    
    let text: String = try doc.body()!.text() // "An example link."
    let linkHref: String = try link.attr("href") // "http://example.com/"
    let linkText: String = try link.text() // "example"
    
    let linkOuterH: String = try link.outerHtml() // "example"
    let linkInnerH: String = try link.html() // "example"
} catch Exception.Error(let type, let message) {
    print(message)
} catch {
    print("error")
}

پیمایش و دستکاری فایل HTML

کتابخانه منبع باز SwiftSoup به توسعه‌دهندگان نرم‌افزار امکان بارگذاری و دستکاری عناصر اسناد HTML را داخل برنامه‌های Swift می‌دهد. این کتابخانه مکانیزمی یکپارچه برای پیمایش گره‌های سند HTML و دستکاری محتوای آن فراهم می‌کند. چه بخواهید داده استخراج کنید، عناصر را تغییر دهید یا گره‌ها را به‌طور کامل حذف کنید، API به شما امکان انجام این کارها را به‌صورت کارآمد می‌دهد. مثال زیر نشان می‌دهد چگونه توسعه‌دهندگان نرم‌افزار می‌توانند با استفاده از دستورات Swift به عناصر اسناد HTML دسترسی پیدا کرده و آن‌ها را تغییر دهند.

import SwiftSoup

do {
    let html = "
مورد 1
مورد 2
"
    let doc = try SwiftSoup.parse(html)
    let items = try doc.select("li")
    for item in items {
        print(try item.text()) // Output: Item 1, Item 2
    }
} catch {
    print("Error parsing HTML: \(error)")
}