หน้าแรก>การเขียนโปรแกรมที่เกี่ยวข้อง>ซอร์สโค้ดอื่น ๆ
ดาวน์โหลด

Safari ผู้ใช้งาน

ตัวแก้ไขผู้ใช้โอเพนซอร์ซสำหรับ Safari

Safari ผู้ใช้งาน

สารบัญ

  • การติดตั้ง
  • การใช้งาน
  • ภาพรวม UI
    • หน้าเบราว์เซอร์
    • การตั้งค่าโมดอล
    • ป๊อปโอเวอร์
  • ข้อมูลเมตา
  • API
  • ไดเรกทอรีสคริปต์ / บันทึกตำแหน่ง
  • ขอความช่วยเหลือ
  • คำถามที่พบบ่อย
  • การบริจาค
  • สนับสนุน
  • นโยบายความเป็นส่วนตัว
  • ใบอนุญาต

การติดตั้ง

ผู้ใช้งานพร้อมใช้งานสำหรับ iOS (iPados) และ MacOS สำหรับทุกรุ่นการติดตั้งจะทำผ่าน App Store ของ Apple บน MacOS เวอร์ชันก่อนหน้า 4.x ได้รับการดาวน์โหลดและติดตั้งโดยตรงจากที่เก็บ แต่เนื่องจากการเปลี่ยนแปลงในวิธีที่ Apple อนุญาตให้นักพัฒนาสามารถแจกจ่ายแอพที่สร้างขึ้นด้วย WEBEXTENSION API ซึ่งไม่ใช่ตัวเลือกอีกต่อไป

ในการเรียกใช้ Userscripts บน iOS คุณควรอยู่บน iOS 15.1 หรือสูงกว่า

ในการเรียกใช้ Userscripts บน MacOS คุณควรใช้ MacOS 12 หรือสูงกว่าพร้อมกับ Safari 14.1 หรือสูงกว่า

ลิงค์ App Store

ความก้าวหน้าในการพัฒนา

การใช้งาน

ขอแนะนำให้อ่านเอกสารนี้และหากคุณมีเวลาดูภาพรวมวิดีโอต่อไปนี้เพื่อทำความคุ้นเคยกับแอพและส่วนขยาย

เมื่อแอปถูกดาวน์โหลดและติดตั้งขั้นตอนต่อไปนี้ควรดำเนินการ:

iOS (iPados)

หลังจากติดตั้งแอพ iOS คุณต้องมีสองขั้นตอนหลักในการทำงานส่วนขยาย:

  • เปิดแอพและตั้งค่าไดเรกทอรี (สำหรับการบันทึกและโหลด userscripts)

    • หลังจากผู้ใช้งานสำหรับ iOS v1.5.0 ไดเรกทอรีเริ่มต้นในท้องถิ่นจะถูกตั้งค่าโดยอัตโนมัติ
    • ในเวอร์ชันก่อนหน้าโปรดคลิกปุ่ม Set Userscripts Directory และเลือกไดเรกทอรี

  • เปิดใช้งานส่วนขยายใน Safari (และการอนุญาตให้)

    • จัดการส่วนขยายจากแอพการตั้งค่า (การตั้งค่า> Safari> Extensions) หรือแอพ Safari (ปุ่ม AA บน iPhone, extension-icon บน iPad และที่คุณเปิดอินเทอร์เฟซ popup ของส่วนขยาย)
    • สำหรับประสบการณ์ที่ดีที่สุดขอแนะนำให้คุณ Always Allow ผู้ใช้สำหรับ All Websites

บันทึก

แอปไม่สามารถตรวจพบได้ว่าคุณเปิดใช้งานส่วนขยายใน Safari หรือไม่ดังนั้นพรอมต์แอพจะไม่เปลี่ยนแปลงหลังจากที่คุณเปิดใช้งานส่วนขยาย ขณะนี้อินเทอร์เฟซแอพใช้เพื่อตั้งค่าหรือเปลี่ยนไดเรกทอรี userscripts เท่านั้น

คุณสามารถเลือกโฟลเดอร์ iCloud สำหรับการซิงค์สคริปต์ระหว่าง macOS และ iOS แต่โปรดทราบว่าอาจมีการล่าช้าในการซิงโครไนซ์และคุณอาจพบไฟล์ถูกขับไล่เนื่องจากการเพิ่มประสิทธิภาพ iCloud โปรดดู #424

มีสองวิธีหลักในการติดตั้งสคริปต์ผู้ใช้จากเวอร์ชัน iOS:

  • เยี่ยมชม .user.js url ใน Safari จากนั้นเปิด popup อัพส่วนขยายและคุณจะเห็นพรอมต์การติดตั้ง
  • นอกจากนี้คุณยังสามารถบันทึกไฟล์ .user.js โดยตรงไปยังไดเรกทอรี usescripts ที่คุณตั้งไว้ด้านบน

เคล็ดลับ

ทั้งสองทำงานได้ดีพอ ๆ กันในรุ่น MacOS

เวอร์ชัน iOS ไม่รวมตัวแก้ไขสคริปต์ที่มีให้ในเวอร์ชัน MACOS แต่คุณสามารถแก้ไขไฟล์สคริปต์ในไดเรกทอรีที่คุณตั้งค่าได้โดยตรงบน iOS (ใช้แอพตัวแก้ไขรหัสบุคคลที่สามสนับสนุนการเปิดและแก้ไขในสถานที่)

แม็กอส

หลังจากติดตั้ง userscripts บน MacOS คุณ ไม่ จำเป็นต้องเลือกไดเรกทอรี Userscripts หากคุณไม่ได้วางแผนที่จะซิงค์ผู้ใช้งานระหว่างอุปกรณ์หลายเครื่อง แต่คุณสามารถเลือกใช้ไดเรกทอรีเริ่มต้นซึ่งอยู่ที่ ~/User/Library/Containers/Userscripts/Data/Documents/scripts - อีกครั้งนี่คือพฤติกรรมเริ่มต้น (และอัตโนมัติ) คุณจะต้องเลือกตำแหน่งใหม่หากคุณต้องการจัดเก็บผู้ใช้งานของคุณที่อื่นซึ่งมีประโยชน์อย่างยิ่งหากคุณใช้โปรแกรมแก้ไขรหัสภายนอกเช่นข้อความประเสริฐหรือ VSCODE

อ้างถึงหน้าคู่มืออย่างเป็นทางการของ Apple: ใช้ส่วนขยาย Safari บน Mac ของคุณ

นี่คือคลิปสั้น ๆ ที่แสดงวิธีสร้าง/เพิ่มผู้ใช้ใน Safari ได้อย่างง่ายดายโดยใช้ส่วนขยายนี้บน macOS

ภาพรวม UI

หน้าเบราว์เซอร์:

หน้าต่างแอปพลิเคชันหลัก Safari Safari

  1. ปุ่มขยาย - คลิกปุ่มนี้เพื่อเปิดอินเทอร์เฟซส่วนขยาย
  2. ตัวกรองแถบ - ใช้อินพุตนี้เพื่อกรองรายการในแถบด้านข้างตาม ชื่อ
  3. ปุ่มเรียงลำดับ - เปลี่ยนลำดับของรายการในแถบด้านข้างตามชื่อหรือเวลาแก้ไข
  4. ปุ่มแถบด้านข้าง - อธิบายจากซ้ายไปขวา
    • ปุ่ม settings (แสดงโดย COG) แสดงการตั้งค่า Modal (กล่าวถึงด้านล่าง)
    • ปุ่ม plus ช่วยให้ผู้ใช้สามารถเพิ่มรายการใหม่
      • New CSS เป็น "ผู้ใช้" ที่คาดว่าจะมีรหัส CSS
      • New Javascript เป็นผู้ใช้ต้นแบบที่คาดว่าจะมีรหัส JavaScript
      • New Remote อนุญาตให้ผู้ใช้เพิ่มผู้ใช้โฮสต์ระยะไกล (หรือสไตล์) โดยการป้อนที่อยู่เว็บ ( เช่น: https://www.k21p.com/example.user.js )
  5. TOGGLE ITEM - สลับนี้เปิดใช้งานหรือปิดการใช้งานรายการ
  6. รายการ - นี่คือผู้ใช้ (หรือสไตล์) คลิกที่มันจะโหลดเนื้อหาของมันลงในตัวแก้ไข - คุณสามารถซ่อนคำอธิบายในพื้นที่การตั้งค่า!
  7. ปุ่มตัวแก้ไข (บนสุด) - อธิบายจากซ้ายไปขวา
    • ปุ่มอัปเดต - ปุ่มนี้ช่วยให้คุณสามารถอัปเดตผู้ใช้ที่ตรงตามเงื่อนไขต่อไปนี้
      • ข้อมูลเมตามีแท็ก @version
      • ข้อมูลเมตามีแท็ก @updateURL
    • ปุ่มดาวน์โหลด - คลิกปุ่มนี้เพื่อดาวน์โหลดสำเนาของผู้ใช้ของคุณ
      • หมายเหตุ: ผู้ใช้ทุกคนที่แสดงในอินเทอร์เฟซมีอยู่แล้วในเครื่องในเครื่องของคุณที่ตำแหน่งบันทึกของคุณ - ปุ่มดาวน์โหลดมีวิธีที่รวดเร็วในการดึงสำเนาของไฟล์นั้นโดยไม่จำเป็นต้องคลิกปุ่มการตั้งค่าจากนั้นบันทึก ลิงค์ตำแหน่งภายในการตั้งค่าโมดอล
    • ปุ่มถังขยะ - ย้ายผู้ใช้ที่โหลดในปัจจุบันไปยังถังขยะ - มันจะถูกลบออกจากอินเทอร์เฟซและบันทึกตำแหน่งในภายหลัง
  8. ปุ่มแก้ไข (ด้านล่าง)
    • Discard - ในขณะที่แก้ไขให้เปลี่ยนการเปลี่ยนแปลงที่ไม่ได้บันทึกใด ๆ ที่คุณทำกับ Userscript
    • Save - ในขณะที่การแก้ไขบันทึกการเปลี่ยนแปลงทั้งหมดที่คุณทำกับ Userscript
      • Command + S เป็นแป้นพิมพ์ลัดสำหรับการดำเนินการ

การตั้งค่า Modal:

หน้าต่างการตั้งค่า Safari Userscripts

  • วงเล็บปิดอัตโนมัติ - สลับเปิด/ปิดการปิดวงเล็บอัตโนมัติในตัวแก้ไข
    • สิ่งนี้มีผลต่ออักขระต่อไปนี้: () [] {} "" ''
  • Auto Hint - แสดงคำใบ้ให้เสร็จสมบูรณ์โดยอัตโนมัติขณะแก้ไข
  • ซ่อนคำอธิบาย - ซ่อนคำอธิบายรายการในแถบด้านข้าง
  • แสดง Invisibles - สลับการแสดงของอักขระที่มองไม่เห็นในตัวแก้ไข
  • JavaScript Linter - สลับผ้าใบจาวาสคริปต์พื้นฐานภายในตัวแก้ไข
  • ขนาดแท็บ - จำนวนช่องว่างที่แท็บเท่ากับในขณะที่การแก้ไขเห็นได้ชัดว่าค่าเริ่มต้นเป็น 4 เพราะการใช้ 2 ช่องว่างเป็นความวิกลจริตแบบสัมบูรณ์
  • เปิดใช้งานการฉีด - สลับการฉีดสคริปต์เปิด/ปิดสำหรับหน้าเว็บที่คุณเยี่ยมชม (นี่คือสวิตช์เปิด/ปิด)
  • แสดงจำนวนแถบเครื่องมือ - แสดงตราบนไอคอนแถบเครื่องมือด้วยตัวเลขที่แสดงจำนวนสคริปต์ที่เปิดใช้งานตรงกับ URL สำหรับหน้าคุณ
  • บันทึกตำแหน่ง - ที่ไฟล์ของคุณอยู่ในปัจจุบันและถูกบันทึกไว้ (คลิกข้อความสีน้ำเงินเพื่อเปิดตำแหน่ง)
  • เปลี่ยนตำแหน่งบันทึก (ไอคอน COGS) - ปุ่มนี้อยู่ทางด้านขวาของตำแหน่งบันทึกเป็นทางลัดสำหรับการเปิดแอพโฮสต์ซึ่งจะช่วยให้คุณเปลี่ยนตำแหน่งบันทึก
  • Global Blacklist - อินพุตนี้ยอมรับรายการคั่นด้วยเครื่องหมายจุลภาคของรูปแบบ @match (โครงสร้างรูปแบบการจับคู่) url หน้าเว็บที่ตรงกับรูปแบบในรายการนี้จะถูกละเว้นสำหรับการฉีดสคริปต์

ป๊อปอัป:

  1. เปิดลิงค์หน้า - MacOS เท่านั้น เปิดหน้าเบราว์เซอร์ส่วนขยาย
  2. เปิดใช้งานการสลับการฉีด - เปิด/ปิดการฉีดสคริปต์หน้า (สวิตช์เปิด/ปิด)
  3. Refresh View - รีเฟรชมุมมองป๊อปอัพ
  4. มุมมองการอัปเดตที่มีอยู่ - ส่วนขยายจะตรวจสอบผู้ใช้ทั้งหมดในตำแหน่งบันทึกของคุณสำหรับการอัปเดตและเมื่อพบการอัปเดตจะแสดงในมุมมองนี้
  5. ปุ่มโฟลเดอร์ - บน MacOS ปุ่มนี้จะเปิดไดเรกทอรีตำแหน่งบันทึกของคุณใน Finder, บน iOS ปุ่มนี้จะแสดง "มุมมองสคริปต์ทั้งหมด" ซึ่งคุณสามารถดูสคริปต์ทุกสคริปต์ที่พบในไดเรกทอรีบันทึกตำแหน่งของคุณ "มุมมองสคริปต์ทั้งหมด" ช่วยให้คุณสลับ สคริปต์ผู้ใช้แต่ละคนเปิด/ปิดโดยไม่คำนึงถึงหน้าปัจจุบันที่แสดงในเบราว์เซอร์
  6. ติดตั้งพรอมต์ - เมื่อผู้ใช้งานแสดงในเบราว์เซอร์การแจ้งเตือนนี้จะปรากฏขึ้นทำให้ผู้ใช้มีตัวเลือกในการติดตั้ง Userscript ลงในไดเรกทอรีบันทึกตำแหน่งของพวกเขา
  7. รายการ Userscripts ที่ตรงกัน - รายการนี้แสดงผู้ใช้ที่จับคู่ในปัจจุบันเทียบกับหน้าปัจจุบันที่แสดงในเบราว์เซอร์ผู้ใช้ทั้งหมดที่ตรงกับโดเมนจะแสดงไม่ว่าจะทำงานหรือไม่ก็ตาม ผู้ใช้สามารถคลิก/แตะผู้ใช้กับการสลับเปิด/ปิด หากผู้ใช้งานใช้งานได้สำหรับโดเมนผ่านเฟรมย่อยแท็ก ย่อย จะแสดงถัดไปเป็นตัวบ่งชี้ประเภทไฟล์

ข้อมูลเมตา

ปัจจุบันผู้ใช้ Safari รองรับข้อมูลเมตาผู้ใช้ต่อไปนี้:

  • @name - นี่จะเป็นชื่อที่แสดงในแถบด้านข้างและใช้เป็นชื่อไฟล์ - คุณ ไม่ สามารถใช้ชื่อเดียวกันสำหรับหลายไฟล์ประเภทเดียวกัน
  • @description - ใช้สิ่งนี้เพื่ออธิบายสิ่งที่ผู้ใช้ของคุณทำ - จะแสดงในแถบด้านข้าง - มีการตั้งค่าเพื่อซ่อนคำอธิบาย
  • @icon - นี่ไม่มีฟังก์ชั่นกับตัวจัดการผู้ใช้งานนี้ แต่ ค่าแรก ที่ให้ไว้ในข้อมูลเมตาจะสามารถเข้าถึงได้ในวัตถุ GM_/GM.info
  • @match - รูปแบบการจับคู่โดเมน - คุณสามารถใช้หลายอินสแตนซ์ของฟิลด์นี้หากคุณต้องการการจับคู่โดเมนหลายรายการ - โปรดดูที่: โครงสร้างรูปแบบการจับคู่
    • หมายเหตุ: ส่วนขยายนี้รองรับ http/s เท่านั้น
  • @exclude-match - รูปแบบโดเมนที่คุณ ไม่ ต้องการให้สคริปต์รัน
  • @include - ใช้เพื่อจับคู่กับ URL สำหรับการฉีดลูกโลกและการแสดงออกปกติอ่านเพิ่มเติมได้ที่นี่
  • @exclude - ฟังก์ชั่นในลักษณะเดียวกันกับ @include แต่แทนที่จะฉีดการจับคู่กับค่าของคีย์นี้จะป้องกันการฉีด
  • @inject-into - อนุญาตให้ผู้ใช้เลือกบริบทที่จะฉีดสคริปต์ลงไป
    • อนุญาตให้ผู้ใช้เลือกบริบทที่จะฉีดสคริปต์ลงไป
    • ค่า: auto (ค่าเริ่มต้น), content , page
      • GM API นั้นใช้ได้เฉพาะเมื่อใช้ content
    • ทำงานเช่น FiolentMonkey
  • @run-at
    • อนุญาตให้ผู้ใช้เลือกช่วงเวลาการฉีด
    • เอกสารเริ่มต้นเอกสารส่วนปลาย (ค่าเริ่มต้น), Document-Idle
    • ทำงานเช่น FiolentMonkey
    • JS เท่านั้น
  • @weight
    • อนุญาตให้ผู้ใช้ปรับเวลาฉีดสคริปต์ต่อไป
    • สามารถใช้เพื่อให้แน่ใจว่ามีการฉีดสคริปต์หนึ่งตัวก่อนอื่น
    • ยอมรับเฉพาะจำนวนเต็ม (ลอยสตริงและทุกอย่างอื่นจะถูกละเว้น)
    • ค่าต่ำสุด = 1, ค่าสูงสุด = 999, ตัวเลขที่สูงขึ้น (“ หนักกว่า”) ดำเนินการก่อนหน้านี้
  • @require
    • อนุญาตให้ผู้ใช้รวมทรัพยากรระยะไกลในสคริปต์ของพวกเขา
    • ค่าจะต้องเป็น URL ที่ถูกต้องปัจจุบันไม่มีการสนับสนุนไฟล์ในท้องถิ่น
    • ต้องต้องการทรัพยากรประเภทไฟล์เดียวกัน (JS สำหรับ JS, CSS สำหรับ CSS)
    • เมื่อต้องการทรัพยากรจะมีการดาวน์โหลดและบันทึกในพื้นที่
    • แหล่งข้อมูลจะถูกดาวน์โหลดหนึ่งครั้งที่บันทึกและไม่เคยตรวจสอบการอัปเดตหรือแยกวิเคราะห์
      • หากคุณต้องการอัปเดตทรัพยากรที่ต้องการและ URL จะไม่เปลี่ยนแปลงคุณต้องลบทรัพยากรบันทึกจากนั้นจึงทำการป้อนข้อมูลใหม่
    • ต้องการทรัพยากรระยะไกลตามความเสี่ยงของคุณเองส่วนขยายไม่เคยตรวจสอบรหัสทรัพยากรระยะไกลในทางใดทางหนึ่งและโปรดทราบว่าการใช้ทรัพยากรระยะไกลจากแหล่งที่ไม่น่าเชื่อถืออาจเป็นอันตรายต่อความปลอดภัยส่วนบุคคลของคุณ
  • @version
    • ใช้เพื่อกำหนดเวอร์ชันปัจจุบันของ Userscript
    • เมื่อจับคู่กับ @updateURL สิ่งนี้จะช่วยให้ผู้ใช้อัปเดตผู้ใช้จากแหล่งข้อมูลระยะไกลหากเวอร์ชันในเครื่องของพวกเขาคือ < เวอร์ชันที่ UDD URL
    • @version ไม่ทำอะไรด้วยตัวเองมันจะต้องจับคู่กับ @updateURL สำหรับการอัปเดตระยะไกลเพื่อให้ทำงานได้อย่างถูกต้อง
  • @updateURL
    • URL ระยะไกลเพื่อตรวจสอบเวอร์ชันกับ
    • หากเวอร์ชันของไฟล์ที่อยู่ที่ ULL >
    • @updateURL ไม่ได้ทำอะไรด้วยตัวเองมันจะต้องจับคู่กับ @version สำหรับการอัปเดตระยะไกลเพื่อทำงานอย่างถูกต้อง
  • @downloadURL
    • ตำแหน่งดาวน์โหลดที่เป็นตัวเลือกสำหรับไฟล์ที่อัปเดตจากระยะไกล (*เช่นไฟล์ที่มีทั้ง @version และ @updateURL )
    • เมื่อจับคู่กับ @version และ @updateURL หากเวอร์ชันท้องถิ่นคือ < เวอร์ชันของไฟล์ที่ @updateURL ชี้ไปที่ส่วนขยายจะพยายามอัปเดตรหัสของไฟล์ด้วยเนื้อหาของไฟล์ที่อยู่ที่ @downloadURL
    • @downloadURL ไม่ได้ทำอะไรด้วยตัวเองมันต้องการ @version และ @updateURL เพื่อนำเสนอเพื่อให้ทำงานได้อย่างถูกต้อง
  • @noframes
    • คีย์นี้ไม่มีค่า
    • ป้องกันไม่ให้รหัสถูกฉีดเข้าไปในเฟรมซ้อนกัน
  • @grant
    • การควบคุมที่จำเป็นซึ่ง APIs พิเศษ (ถ้ามี) ของคุณใช้หนึ่งในแต่ละบรรทัด @grant แต่ละบรรทัดจะมีวิธี API เหล่านั้นเท่านั้น
    • หากไม่มีค่า @grant จะ none การสันนิษฐาน
    • หากคุณระบุ none และอย่างอื่น none ความสำคัญ

ผู้ใช้ทั้งหมดต้องการอย่างน้อย 1 @match หรือ @include เพื่อเรียกใช้!

API

ปัจจุบันผู้ใช้งานสนับสนุนวิธี API ต่อไปนี้ วิธีการทั้งหมดเป็นแบบอะซิงโครนัสเว้นแต่จะระบุไว้เป็นอย่างอื่น ผู้ใช้จะต้อง @grant วิธีการเหล่านี้เพื่อใช้ในผู้ใช้ เมื่อใช้วิธี API เป็นไปได้ที่จะฉีดเข้าไปในขอบเขตสคริปต์เนื้อหาเนื่องจากความกังวลด้านความปลอดภัย

บันทึก

คำอธิบาย API ต่อไปนี้ใช้กับสาขาการพัฒนาล่าสุดคุณอาจต้องตรวจสอบเอกสารสำหรับเวอร์ชันที่เกี่ยวข้อง โปรดเปลี่ยนเป็นเวอร์ชันที่คุณต้องการตรวจสอบผ่าน Branches หรือ Tags ที่ด้านบน

ตัวอย่างเช่นสำหรับ App Store เวอร์ชัน v4.xx: https://github.com/quoid/userscripts/tree/release/4.xx

สำหรับคำจำกัดความประเภท API โปรดดู: types.d.ts

  • GM.addStyle(css)
    • css: String
    • ส่งคืน Promise ที่ได้รับการแก้ไขหากประสบความสำเร็จปฏิเสธด้วยข้อความแสดงข้อผิดพลาดหากล้มเหลว
  • GM.setValue(key, value)
    • key: String
    • value: Any - ใด ๆ ที่สามารถ json -serialized
    • ส่งคืน Promise ที่ได้รับการแก้ไขหากประสบความสำเร็จปฏิเสธด้วยข้อความแสดงข้อผิดพลาดหากล้มเหลว
  • GM.getValue(key, defaultValue)
    • key: String
    • defaultValue: Any - ไม่บังคับ
    • ส่งคืน Promise ที่ได้รับการแก้ไขด้วย value ที่ตั้งไว้หรือ defaultValue ที่ให้ไว้หรือ undefined หากสำเร็จจะถูกปฏิเสธด้วยข้อความแสดงข้อผิดพลาดหากล้มเหลว
  • GM.deleteValue(key)
    • key: String
    • ส่งคืน Promise ที่ได้รับการแก้ไขหากประสบความสำเร็จปฏิเสธด้วยข้อความแสดงข้อผิดพลาดหากล้มเหลว
  • GM.listValues()
    • ส่งคืน Promise ที่ได้รับการแก้ไขด้วยอาร์เรย์ของชื่อคีย์ของค่า ที่ตั้งไว้ในปัจจุบัน หากสำเร็จโดยปฏิเสธด้วยข้อความแสดงข้อผิดพลาดหากล้มเหลว
  • GM.getTab()
    • ส่งคืน Promise ที่ได้รับการแก้ไขด้วยข้อมูล Any ที่คงอยู่ตราบใดที่แท็บนี้เปิดอยู่หากประสบความสำเร็จปฏิเสธด้วยข้อความแสดงข้อผิดพลาดหากล้มเหลว
  • GM.saveTab(tabObj)
    • tabObj: Any - ใด ๆ ที่สามารถ json -serialized
    • ส่งคืน Promise ที่ได้รับการแก้ไขหากประสบความสำเร็จปฏิเสธด้วยข้อความแสดงข้อผิดพลาดหากล้มเหลว
  • GM.openInTab(url, openInBackground)
    • url: String
    • openInBackground: Bool - เป็นตัวเลือก, false โดยค่าเริ่มต้น
    • ส่งคืน Promise ที่ได้รับการแก้ไขด้วยข้อมูล TAB สำหรับแท็บที่เพิ่งเปิดหากประสบความสำเร็จปฏิเสธด้วยข้อความแสดงข้อผิดพลาดหากล้มเหลว
  • GM.closeTab(tabId)
    • tabId: Int - ไม่บังคับ caller tab ตามค่าเริ่มต้น
    • ส่งคืน Promise ที่ได้รับการแก้ไขหากประสบความสำเร็จปฏิเสธด้วยข้อความแสดงข้อผิดพลาดหากล้มเหลว
  • GM.setClipboard(data, type)
    • data: String
    • type: String - ตัวเลือก text/plain โดยค่าเริ่มต้น
    • อ่านเพิ่มเติมที่นี่
    • ส่งคืน Promise ที่ได้รับการแก้ไขด้วยค่า Bool ที่ระบุว่าประสบความสำเร็จหรือล้มเหลวปฏิเสธด้วยข้อความแสดงข้อผิดพลาดหากล้มเหลว
  • GM.info && GM_info
    • พร้อมใช้งานโดยไม่จำเป็นต้องเพิ่มลงใน @grant
    • วัตถุที่มีข้อมูลเกี่ยวกับผู้ใช้ที่กำลังทำงานอยู่
      • scriptHandler: String - return Userscripts
      • version: String - แอพเวอร์ชัน Userscripts
      • scriptMetaStr: String - The Metablock สำหรับสคริปต์ที่กำลังทำงานอยู่ในปัจจุบัน
      • script: Object - มีข้อมูลเกี่ยวกับสคริปต์ที่กำลังทำงานอยู่ในปัจจุบัน
        • description: String
        • exclude-match: [String]
        • excludes: [String]
        • grant: [String]
        • includes: [String]
        • inject-into: String
        • matches: [String]
        • name: String
        • namespace: String
        • noframes: Bool
        • require: [String]
        • resources: [String] - ปัจจุบันยังไม่ได้ใช้งาน
        • run-at: String
        • version: String - ค่าเวอร์ชัน Userscript
  • GM.xmlHttpRequest(details)
    • details: Object
    • วัตถุ details ยอมรับคุณสมบัติต่อไปนี้
      • url: String - จำเป็น
      • method: String - ไม่บังคับ GET ตามค่าเริ่มต้น
      • user: String - เสริม
      • password: String - เป็นทางเลือก
      • headers: Object - เป็นทางเลือก
      • overrideMimeType: String - เป็นตัวเลือก
      • timeout: Int - ไม่บังคับ
      • binary: Bool - เป็นตัวเลือก (เลิกใช้แล้ว, ใช้วัตถุข้อมูลไบนารีเช่น Blob , ArrayBuffer , TypedArray ฯลฯ แทน)
      • data: String | Blob | ArrayBuffer | TypedArray | DataView | FormData | URLSearchParams - เป็นทางเลือก
      • responseType: String - ไม่บังคับ
      • อ้างถึง XMLHttpRequests
    • ตัวจัดการเหตุการณ์:
      • onabort: Function - ไม่บังคับ
      • onerror: Function - ไม่บังคับ
      • onload: Function - เป็นทางเลือก
      • onloadend: Function - ไม่บังคับ
      • onloadstart: Function - ไม่บังคับ
      • onprogress: Function - ไม่บังคับ
      • onreadystatechange: Function - ไม่บังคับ
      • ontimeout: Function - ไม่บังคับ
      • วัตถุตอบสนองที่ส่งผ่านไปยังตัวจัดการเหตุการณ์มีคุณสมบัติดังต่อไปนี้:
        • readyState
        • response
        • responseHeaders
        • responseType
        • responseURL
        • status
        • statusText
        • timeout
        • responseText (เมื่อ responseType เป็น text )
    • ส่งคืน Promise ที่กำหนดเองมี abort คุณสมบัติเพิ่มเติมแก้ไขด้วยวัตถุตอบกลับ
      • การใช้งาน:
        • const xhr = GM.xmlHttpRequest({...});
        • xhr.abort(); ยกเลิกคำขอ
        • const response = await xhr;
      • หรือเพียงแค่:
        • const response = await GM.xmlHttpRequest({...});
  • GM_xmlhttpRequest(details)
    • โดยทั่วไปเหมือนกับ GM.xmlHttpRequest(details) ยกเว้น:
    • ส่งคืนวัตถุด้วยคุณสมบัติเดียว abort ซึ่งเป็น Function
      • การใช้งาน: const foo = GM.xmlHttpRequest({...}); ... foo.abort(); ยกเลิกคำขอ

ไดเรกทอรีสคริปต์

นี่คือไดเรกทอรีที่แอพ/ส่วนขยายจะอ่านและเขียนถึง ไดเรกทอรีนี้มีการเปลี่ยนแปลงโดยการเปิด แอพที่มีอยู่ และคลิกปุ่ม "เปลี่ยนตำแหน่ง" ที่เกี่ยวข้อง

บันทึกไดเรกทอรีสคริปต์

  • ปิดอินสแตนซ์ทั้งหมดของส่วนขยาย UI (แอพเบราว์เซอร์และ/หรือป๊อปอัป) ก่อนเปลี่ยนไดเรกทอรีสคริปต์
  • หลังจากเพิ่มไฟล์แล้วลบหรือแก้ไขแล้วคุณจะต้องเปิดป๊อปอัปอย่างน้อย 1 ครั้งเพื่อดูการเปลี่ยนแปลงเหล่านั้นที่สะท้อนในประสบการณ์การเรียกดูของคุณ
  • บน MacOS หลังจากเลือกไดเรกทอรีด้านนอกของค่าเริ่มต้นหากคุณเปลี่ยนชื่อหรือย้ายไดเรกทอรีที่เลือกนั้นส่วนขยายจะยังคงอ่าน/เขียนไปยังไดเรกทอรีนั้น - วิธีเดียวที่จะลบ“ ลิงก์” คือการทิ้งโฟลเดอร์หรือเลือก สถานที่บันทึกใหม่

ขอความช่วยเหลือ

หากคุณพบปัญหาในขณะที่ใช้แอพ/ส่วนขยายนี้หรือต้องการความช่วยเหลือบางอย่างโปรดเปิดปัญหาที่นี่ในที่เก็บ เมื่อทำเช่นนั้นโปรดให้รายละเอียดมากที่สุด ซึ่งรวมถึงข้อมูลจำเพาะระบบรายชื่อและเว็บไซต์และสคริปต์ที่คุณพยายามดำเนินการ โปรดติดตามเทมเพลตปัญหา!

คำถามที่พบบ่อย

"ปฏิเสธที่จะเรียกใช้สคริปต์" ข้อผิดพลาดฉันควรทำอย่างไร!

คุณเห็นข้อผิดพลาดนี้เนื่องจากนโยบายความปลอดภัยเนื้อหาของเว็บไซต์ ขณะนี้ไม่มีวิธีที่จะอนุญาตให้สคริปต์เนื้อหาส่วนขยายผ่าน CSPS ใน Safari

โดยอัตโนมัติส่วนขยายจะพยายามหลีกเลี่ยง CSP ที่เข้มงวด แต่ถ้าคุณยังคงประสบปัญหาลองตั้งค่าคีย์เมตาดาต้า Userscript // val // @inject-into auto หรือ // @inject-into content

คุณสามารถอ่านเพิ่มเติมเกี่ยวกับเรื่องนี้ในฉบับนี้

ฉันจำเป็นต้องใช้ตัวแก้ไขของส่วนขยายเพื่อสร้างผู้ใช้ใหม่หรือเพื่อแก้ไขที่มีอยู่หรือไม่?

คุณสามารถใช้ตัวแก้ไขของคุณเองเพื่ออัปเดตและจัดการไฟล์ของคุณ ตราบใดที่คุณกำลังบันทึกไฟล์ไปยังตำแหน่งที่บันทึกไว้และมีการจัดรูปแบบอย่างเหมาะสมพวกเขาควรได้รับการฉีด อย่างไรก็ตามคุณ ต้องเปิดป๊อปอัพส่วนขยาย ล่วงหน้า นั่นหมายความว่าหากคุณสร้างใหม่หรือแก้ไขผู้ใช้ที่มีอยู่ด้วยตัวแก้ไขภายนอกและบันทึกลงในตำแหน่งบันทึกก่อนที่จะฉีดจะเกิดขึ้นอย่างถูกต้องควรเปิดป๊อปอัพส่วนขยายและป๊อปอัปจะต้องโหลดอย่างสมบูรณ์

แป้นพิมพ์ลัดคืออะไร?

ในขณะที่ใช้ตัวแก้ไขที่รวมอยู่การคลิก ⌘ + s จะบันทึกไฟล์ ในขณะที่ทำงานตัวแก้ไขการคลิก ⌘ + f จะเปิดแถบค้นหาและ esc จะซ่อนมันไว้

เมื่อฉันใช้ @require ไฟล์ที่ต้องการจะถูกเก็บไว้ที่ไหน

ไฟล์ที่ต้องการทั้งหมดจะถูกบันทึก เป็นไฟล์ JavaScript ในโฟลเดอร์ Container Extension ใน MacOS 11.x โฟลเดอร์นั้นอยู่ในตำแหน่งบันทึกเริ่มต้นที่: ~/Library/Containers/Userscripts/Data/Documents/require/

หากคุณย้ายไฟล์จากโฟลเดอร์ที่ต้องการหรือแก้ไขไฟล์ manifest.json ด้วยตนเองคุณอาจทำลายฟังก์ชันแอพ/ส่วนขยาย

การบริจาค

การบริจาคระดับรหัสโปรดดูที่การสนับสนุน. md

นอกจากนี้ปัญหาใด ๆ ที่ทำเครื่องหมายไว้ "ต้องการความช่วยเหลือ" กำลังขอความช่วยเหลืออย่างแข็งขัน โปรดตอบสนองต่อปัญหาเหล่านั้นด้วยข้อเสนอแนะคำแนะนำหรือข้อเสนอของความช่วยเหลือการเข้ารหัส

การเข้าร่วมและโต้ตอบกับ Issues หรือ Discussions ที่มีอยู่จะเป็นความช่วยเหลือที่ดีสำหรับโครงการและชุมชนโอเพ่นซอร์ส ขอบคุณสำหรับการมีส่วนร่วมของคุณ

สนับสนุน

วิธีที่เร็วที่สุดและง่ายที่สุดในการสนับสนุนโครงการคือการทิ้งรีวิวในเชิงบวกใน App Store หากคุณสนุกกับการขยายและต้องการดูการปรับปรุงในอนาคต การเห็นบทวิจารณ์เหล่านี้แจ้งให้เราทราบว่าฉันกำลังทำสิ่งที่ถูกต้องหรือผิดและกระตุ้นให้ฉันทำงานต่อไปในโครงการต่อไป

วิธีที่ดีที่สุดอันดับสองในการช่วยเหลือคือการลงทะเบียนเพื่อทดสอบเบต้าเวอร์ชันใหม่ของแอพ เนื่องจากส่วนขยายนี้ให้ความสำคัญกับความเป็นส่วนตัวของคุณและ ไม่ได้รวบรวมข้อมูลใด ๆ จากผู้ใช้ จึงเป็นเรื่องยากที่จะวัดว่ามีการใช้ส่วนขยายอย่างไร โดยการลงทะเบียนเป็นเครื่องทดสอบเบต้าไม่เพียง แต่ช่วยให้คุณทดสอบคุณสมบัติที่กำลังจะมาถึง แต่ยังเปิดโอกาสให้ฉันได้รับการตอบรับโดยตรงจากผู้ใช้จริง

โปรดเข้าร่วมและทดสอบรุ่นเบต้าที่เกี่ยวข้องในรุ่นผ่านลิงก์สาธารณะ TestFlight

นโยบายความเป็นส่วนตัว

ผู้ใช้ไม่ได้รวบรวมข้อมูลใด ๆ จากผู้ใช้หรือตรวจสอบกิจกรรมหรือการกระทำที่คุณดำเนินการภายในแอปพลิเคชันและส่วนขยาย ซึ่งหมายความว่าทุกสิ่งที่คุณทำกับแอปพลิเคชันและส่วนขยายเป็นเรื่องส่วนตัวสำหรับคุณและไม่เคยแบ่งปันกับนักพัฒนาหรือบุคคลที่สาม เนื่องจากไม่มีการรวบรวมข้อมูลจึงไม่มีการเก็บข้อมูลใด ๆ

ใบอนุญาต

ลิขสิทธิ์ (c) 2018-2024 Justin Wasack

ได้รับใบอนุญาตภายใต้ใบอนุญาตสาธารณะ GNU ทั่วไป v3.0 ใบอนุญาตสำหรับแอปพลิเคชันโอเพ่นซอร์สทั้งหมด จำเป็นต้องมีใบอนุญาตเชิงพาณิชย์สำหรับแอปพลิเคชันอื่น ๆ ทั้งหมด

ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด