Untuk memeriksa apakah pintasan Mac mengodekan teks pencarian yang dipilih, periksa nilai yang masuk ke URL akhirnya: tambahkan tindakan Lihat Cepat (Quick Look) setelah pintasan membuat URL, jalankan dengan frasa pengujian yang berisi spasi dan karakter khusus, lalu periksa apakah karakter-karakter tersebut muncul sebagai percent escape. Keberhasilan menjalankan pintasan saja tidak membuktikan bahwa teks pencarian telah dikodekan dengan benar; URL yang terlihat memberi Anda cara untuk memeriksa apa yang sebenarnya disusun oleh pintasan tersebut. Apple mendokumentasikan Lihat Cepat untuk mempratinjau konten yang diteruskan antartindakan pintasan, dan panduan Mac-nya menjelaskan alur kerja berbasis URL yang mengharuskan teks dienkode URL. (Testing your actions in Shortcuts on Mac; Use another app’s URL scheme in Shortcuts on Mac)

Identifikasi teks dan URL yang perlu Anda periksa

Pintasan pencarian biasanya mengambil frasa yang dipilih, memasukkannya ke dalam URL pencarian, dan membuka URL tersebut. Bagian yang perlu diperiksa adalah nilai kueri yang memuat frasa tersebut—bukan hanya apakah URL akhir dimulai dengan alamat web. Misalnya, jika URL pencarian memiliki bentuk https://example.com/search?q=..., periksa nilai setelah q=. Domain contoh ini hanya bersifat ilustratif; gunakan layanan pencarian dan parameter sebenarnya yang menjadi tujuan pembuatan pintasan Anda.

Periksa tindakan pintasan dari atas ke bawah. Temukan di mana teks yang dipilih masuk ke dalam alur kerja, di mana URL atau kueri pencarian disusun, dan tindakan yang membuka URL tersebut. Panduan Pintasan Apple menjelaskan bahwa tindakan yang terhubung meneruskan outputnya ke langkah berikutnya, dan bahwa tindakan Lihat Cepat dapat mempratinjau konten yang berpindah antartindakan. (Action connections in Shortcuts on Mac; Testing your actions in Shortcuts on Mac)

Sediakan teks yang dipilih untuk pintasan Mac

Jika Anda memeriksa pintasan yang sudah ada, pastikan pintasan tersebut dikonfigurasi untuk menerima teks yang dipilih. Di Pintasan, buka pintasan tersebut, buka Detailnya, dan aktifkan Gunakan sebagai Tindakan Cepat atau Tampilkan di Lembar Berbagi. Apple menyatakan bahwa ini menambahkan tindakan input di awal alur kerja. Kemudian pilih frasa di sebuah aplikasi dan jalankan pintasan dari opsi berbagi atau Tindakan Cepat yang tersedia di aplikasi tersebut. Menu pastinya bergantung pada aplikasi dan cara pintasan tersebut diaktifkan. (Run a shortcut while working on your Mac)

Pintasan yang diluncurkan dari Dock tidak menerima konten dari aplikasi saat ini, menurut Apple. Jika Anda meluncurkannya dengan cara itu, pintasan mungkin berjalan tanpa teks pilihan yang ingin Anda uji. Periksa tindakan input pintasan dan jalankan dari aplikasi sumber yang didukung dengan teks yang telah dipilih. (Run a shortcut while working on your Mac; Limit the input for a shortcut when run from another app on Mac)

Pratinjau URL yang telah selesai sebelum dibuka

Di editor pintasan, sisipkan Lihat Cepat di antara tindakan yang membuat URL akhir dan tindakan yang membukanya. Jalankan pintasan dengan frasa pengujian yang aman seperti red & blue sky. Lihat Cepat akan menampilkan output dari tindakan sebelumnya. Ini memungkinkan Anda memeriksa URL yang disusun sebelum tindakan pembuka menerimanya; hal ini sendiri tidak memvalidasi apakah penyedia pencarian menerima URL tersebut atau menafsirkan kueri seperti yang diharapkan. Apple merekomendasikan Lihat Cepat sebagai cara untuk mengidentifikasi konten apa yang mengalir antartindakan pintasan. (Testing your actions in Shortcuts on Mac)

Baca nilai kueri di pratinjau. Dalam komponen kueri standar yang dienkode persen, spasi dapat muncul sebagai %20, dan tanda ampersand (&) yang merupakan bagian dari frasa pencarian dapat muncul sebagai %26. Jika ampersand tetap berupa karakter literal & di dalam nilai tersebut, pengurai URL dapat menganggapnya sebagai awal dari parameter lain. Ini adalah contoh diagnostik, bukan jaminan tentang format kueri setiap layanan pencarian. Contoh skema URL Pintasan Apple sendiri menggunakan %20 untuk spasi dan secara eksplisit mendeskripsikan teks yang dimasukkan sebagai teks yang dienkode URL. (Run a shortcut using a URL scheme on Mac)

Periksa tindakan mana yang melakukan pengodean

Cari tindakan di editor untuk URL Encode (Enkode URL) dan periksa apakah tindakan tersebut menerima variabel teks yang dipilih sebelum nilai tersebut dimasukkan ke dalam kueri. Tujuan tindakan yang terdokumentasi adalah untuk mengenkode atau mendekode teks untuk digunakan dalam URL dengan menambahkan atau menghapus percent escape. (URL Encode) Apple juga mendokumentasikan pembuatan URL dengan tindakan URL dan membukanya dengan Buka URL (Open URLs) atau Buka URL X-Callback (Open X-Callback URL), tetapi panduannya memperingatkan bahwa skema URL dapat memerlukan teks yang dienkode dan mungkin sulit untuk didebug. (Use another app’s URL scheme in Shortcuts on Mac)

Pemeriksaan yang berguna terletak pada posisi tindakan dan pratinjaunya, bukan hanya sekadar keberadaan tindakan dengan kata "URL" pada namanya. Pastikan teks yang dipilih mengalir ke langkah pengodean, dan bahwa hasil yang telah dikodekan—bukan teks pilihan asli—adalah yang dimasukkan sebagai nilai kueri. Kemudian konfirmasikan bahwa pratinjau Lihat Cepat menampilkan karakter escape yang diharapkan. Hindari mengodekan nilai yang sudah dienkode untuk kedua kalinya: tanda persen itu sendiri dapat ikut terenkode, mengubah %20 menjadi %2520. Pola tersebut dalam pratinjau adalah petunjuk untuk memeriksa alur kerja dari adanya pengodean berulang.

Menafsirkan hasil dan batasannya

Jika pratinjau menampilkan spasi dan karakter khusus yang telah di-escape di dalam nilai kueri, itu adalah bukti bahwa URL yang disusun berisi teks yang telah dienkode. Jika menampilkan spasi mentah, teks yang dipilih mungkin belum melewati pengenkode, variabel yang salah mungkin telah dimasukkan, atau Anda mungkin melihat pratinjau output dari tindakan sebelumnya. Jika frasa tidak ada, periksa input pintasan dan koneksi variabel sebelum mengubah struktur URL-nya.

Pratinjau dapat menunjukkan string URL yang disusun oleh pintasan; pratinjau tidak dapat memastikan bagaimana layanan pencarian tertentu akan memproses kueri tersebut, apakah URL berhasil dibuka, atau apakah layanan tersebut menerapkan aturannya sendiri. Untuk pemeriksaan fungsi akhir, hapus atau pindahkan tindakan diagnostik Lihat Cepat dan gunakan pintasan tersebut dengan contoh frasa yang tidak sensitif. Apple mendokumentasikan kontrol Mac untuk menerima konten dan membuka URL, tetapi tidak menjanjikan perilaku kueri yang identik di berbagai layanan pencarian. (Run a shortcut while working on your Mac; Use another app’s URL scheme in Shortcuts on Mac)

Sumber